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Overview 


Business agility through synchronized business and iT cycles 

The ability to deal with change in operational systems is directly related to the decisions that they are 
able to make. Every transaction, order, customer interaction or process is dependent on decisions, which 
are in turn dependent on particular internal or external requirements and situational contexts. Every 
change therefore affects decisions, many of which are handled automatically within business systems. 

Business agility depends on responsive, intelligent decision automation. With WebSphere Operational 
Decision Management, you manage decisions separately from business applications, with more flexibility 
and responsiveness to the changing needs your business. 

When decision management is separate from application code, business experts can define and manage 
the business logic, reducing the amount of time and effort required to update that business logic in 
production systems, and increasing the ability of an organization to respond to changes in the business 
environment. 

WebSphere Operational Decision Management includes two main components, on both distributed and 
z/OS platforms: 

• Decision Server for managing decisions separately from applications. 

New IT architectures like Service Oriented Architecture (SOA) allow loose coupling of the 
applications or processes. Business logic can be encapsulated as decision services, which the 
applications and processes can call. Decision services enable the operation of Business Process 
Management (BPM) solutions with decision management. 

• Decision Center for putting decision management in the hands of those who drive the business. 

Business users can manage decisions directly with limited dependence on the IT department. 

The degree of dependence can range from limited review by business users of the business logic 
implemented by developers to complete control over the specification, creation, testing, and 
deployment of the business logic by business users. 


From business policy to business rules 

Business policies are statements that are used to make decisions such as pricing for insurance or loan 
underwriting, eligibility approvals for social or health services, or product recommendations for online 
purchases. Business policies are typically found inside application code, in the form of if-then statements, 
although they may also be stored elsewhere for documentation purposes, such as in procedural manuals 
and other documents. 

A business policy can be expressed as several business rules. Here is an example of the kind of 
business policy that might be familiar: 

Customers who spend a lot of money in a single transaction need an upgrade. 
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The process of capturing rules consists of formalizing the vocabulary required to express the policy as a 
conceptual object model and representing the logic of the business policy as if-then statements. 

After the vocabulary has been created, the above business policy can be implemented with the following 
business rule: 

if 


the customer's category is Gold 

and the value of the customer's shopping cart is more than $1500 


then 


change the customer's category to Platinum 

When a business policy also has an IT policy or security policy embedded in it, you can combine 
Business Rule Management with additional capabilities to handle the business policy aspects. For 
example, customers who spend a lot of money should be routed to a preferential service or customers 
who spend a lot of money require additional security on their transactions. 

In the form of business rules, the business logic can be packaged and called from the application code 
as a business rule application. Therefore, changes to the business policy do not require changes to the 
application or process code. 


From event pattern detection to event rules 

An event is an electronic signal indicating that a change in the state of the business has occurred. 
Orchestrating business events so that the right applications run at the right time for the right purpose is a 
challenge that can be particularly difficult with the large variety of business systems currently running in 
the enterprise. A wide range of technologies is also employed, ranging from batch processing 
applications to client/server, and to browser-based intranet and internet applications. Orchestrating the 
processing of the events that occur in these systems, as well as the events that occur manually, might 
potentially mean major system redesign and many months of modifications, tests, and deployment. 

A rapid business systems orchestration requires an alternative approach to complex and expensive 
redesign and redeployment of existing systems is required. The solution is to implement a Business 
Event Processing layer that sits across existing systems, takes advantage of functions already 
developed in those systems, and manages the complex interactions (business events) that can occur 
between those systems. This layer of architecture is known as Business Event Processing. The Business 
Event Processing layer communicates significant events in one business system to other systems that 
require the information to respond to the critical event. 

In large organizations, tens of millions of events occur everyday, but not all events or event occurrences 
are of equal importance. Providing insight requires the ability to determine when a pattern of seemingly 
unrelated events from one or more sources has occurred and then to coordinate the execution of the 
responses to that pattern of events. 

Business Event Processing is the ability to sense when a business event or event pattern has occurred 
(or not occurred), indicating an actionable business situation, and to coordinate the right response or 
action, at the right time. 
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Event rules help detect, and respond to, event patterns among like or related events, missing events and 
aggregate events. Event rules also relate the pattern detection to a context and apply a dimension of 
time to the pattern. So, for example, the following logic can be created: 

if events A and B occur and event C does not occur in <time frame>, then do 
actions X, Y and Z after time frame 

For example, on a retail web site, if a customer adds a book to his or her shopping basket (event A) and 
views the delivery information page (event B) but does not complete the purchase at the online checkout 
(event C) within one week, then send an E-mail to this customer (action X). After one more day has 
passed, update the customer favorites database with the book details (action Y), and send a message to 
the Sales department to tell them this customer did not complete the purchase (action Z). 

By using predefined logic that describes how business systems are to interact, the event runtime can 
notify those systems in real time so that they take the appropriate action. 


Synchronized business and IT cycies 

WebSphere Operational Decision Management provides an environment for designing, developing, and 
deploying business rule applications and event applications. The IT cycle consists of developing and 
maintaining this infrastructure. After the infrastructure is set up, distributed business teams can start 
collaborating through a Web-based environment to create and maintain business rules and events. 

The life cycles of decision management and application development can evolve in parallel. Decisions 
can evolve as required by the business context, without putting an extra load on the development of the 
application. Each time the application evolves, the decision management environment synchronizes with 
the application. 

With this separation, decisions and application architecture can be managed asynchronously. For 
example, application developers can develop a new application version in response to changing 
application infrastructure and additional core business requirements. At the same time, policy managers 
can work on new decisions delivered in response to an evolving market, changing regulatory 
environment, or new patterns of events. 
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In addition to working on different time lines, developers and business users also expect to work with 
different tools, reflecting their different skill sets and views of the application. 

For example, developers are accustomed to the Java world. They use source-code management 
systems to work simultaneously on separate copies of a project without interfering with each other. 

Business users, on the other hand, do not concern themselves with the details of application 
development, but are interested in testing and managing decisions. Therefore, they need tools that can 
help them author, organize, and search for rules in the context of the overall policy. 

With developers and business users working in their own environments at their own pace, the work of 
these two groups must be synchronized and merged. 

Finally, both developers and business users require access to a rule execution environment to deploy 
rules to enable testing, validation, and rollout to production of new and changed business logic. 
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Introduction 

This section describes the scenario you will work through during this tutorial. 


The Miniloan Business Application 

The getting started tutorial is based on a web based online loan application. The tutorial objective is to 
modify the application to support the new business process shown below. On receipt of the Loan 
application, the borrowers’ credit score would be checked and the interest rate identified. This 
information would normally be provided from existing services within the organization so for the tutorial 
will be provided as part of the input data. The Debt-To-Income (DTI) and the Yearly Repayments will be 
calculated thanks to the rules in the step Computation. 



The next stage in the process is to make a decision about whether the loan should be accepted or not. 
This decision will use business rules to determine the loan risk based on the relative debt to income ratio 
and the borrowers’ credit score. If the loan is not approved, the borrower is informed that the loan has 
been rejected together with the reasons. 

A additional stage could be to use event based decision making to determine if the borrower has already 
been offered a loan several times but is still continuing to submit new applications. If any particular 
borrower has already been offered a loan 3 times, another offer should not be made but the borrower 
should be requested to contact a helpdesk to follow up (and accept) the existing offer. 


The Miniloan Information Modei 

The information available to make the decision is shown below. 
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H] Schema: minfloan 


£5 Directives 


® Elements 

0Types 

\M1 borrower : Borrower 

[E Borrower 

\M\ loan : Loan 


[E Loan 

\ 


IB Borrower 

—Ill name string 

fcl— HI creditScore int 
—HI yearlyincome int 


E Loan 


— [H amount 


int 

— H duration 


int 

—{Ml yearlyInterestRate 


double 

— H ye a rlyRe payment 

[0„1] 

int 

—{Ml status 

[0„1] 

(statusType) 

—{Ml messages 

[0,,*] 

string 


The Borrower represents the person applying for the loan. They are identified by a name and have a 
yearly income which is used to assess their debt to income ratio. In order to make a good decision about 
the risk of the loan, the borrower’s credit score is also required. This would usually be provided from an 
outside source but for these purposes we will have to supply this information as input. 

The Loan represents the loan characteristics and is divided up into three sections. 

• The amount and the duration (or repayment period in months) will be provided by the borrower. 

• The yearly interest rate will be provided by the application at submission time. It could be modified 
by the rules but in our example it is fixed. 

• The yearly repayment and the loan status will be populated by the rules. 


Introducing the Tutorial Environment 

This section introduces the components you will use in the tutorial and the steps you will take. 


The WebSphere Operational Decision Management WODM modules 

WebSphere Operational Decision Management comprises a set of modules that operate in different 
environments, but also work together to provide a comprehensive decision management platform. 

• Rule Designer - is an integrated development environment (IDE) for rule applications that 

integrates directly into the Eclipse family of integrated development environments, including Eclipse, 
IBM Rational Application Developer (RAD) and ISM Rational Software Architect (RSA). Rule 
Designer is used by developers and architects to develop and integrate business rule sets into 
applications. 
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• Rule Execution Server - is a robust, J2SE and J2EE-compliant execution environment for 
deploying business rule SOA services to the leading web and application servers such as 
WebSphere Application Server. The Rule Execution Server includes components for synchronous, 
asynchronous and web service based invocation of business rules and includes a web 
administration console. The Rule Execution Server is fully integrated with the Rule Designer and 
Decision Center to support business rule deployment for both developers and policy managers. 


• Decision Center - A scalable rule management server and repository with a collaborative web 
environment for authoring, managing, validating, and deploying business rules. Decision Center 
provides project governance, including role-based security, history maintenance, and custom 
metadata. Decision Center provides enhanced collaboration between teams through multi-user 
access for business users and synchronization between IT and business user environments. 

• Rule Solutions for Office - is used for offline authoring and sharing of the business rules using 
standard office tools. Rule authors write rules in Microsoft Word and edit decision tables in Microsoft 
Excel. They can create mixed rule and non-rule content in a RuleDoc, and retain semantic 
information together with the actual implementation content of the rules. 


Rule application development 


Deve/pper 




Designer 


A 




Rule management and authoring 


Business anatyst 
Design Synchronize 


i P 

Rule author Policy manager 

j. 


Author 

Test 

Deploy 


Integrate 


Deveioper 

Enterprise applications 


A 

\r 




Afchitect 



Decision Center 


Author 

Review 

Validate 

Administer 

Deploy 


Administrator 



Monitor 

Audit 




Rule Runtime 


Administrator 


Two categories of users are involved in developing and maintaining a decision management solution: 

IT users 

Architects, developers, and administrators develop and maintain the rule application. 

Developers work with Rule Designer in Eclipse for design, Java development, and rule project 
development. Using Decision Validation Services, they can also test rulesets against real or fictitious 
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scenarios to support and troubleshoot problems found in Decision Center. 


Business users 


• Business users work with Decision Center to write and maintain business rules, both during 
application development and after the application is deployed to production. 

• Business users can perform end-user testing and simulation in Decision Center. Business analysts 
can simulate business outcomes, run updated rules against historical data, simulate expected 
changes in data profiles against existing rules, and analyze aggregate outcomes. 

• Policy managers and other business users can use Rule Solutions for Office to author rules, in a 
familiar environment. RuleDocs are Microsoft Office documents that contain business rules. Business 
users can publish RuleDocs from Decision Center, edit the RuleDocs in Word or Excel, and update 
their changes back into Decision Center. 

• RuleDocs can be published to any WebDAV server and can be short-lived or managed in a content 
management system such as SharePoint. 


Overview of Tutorial tasks 

The tutorial also offers an introduction to both Decision Server and Decision Center where you take 
the role of a business user first to manage the business rules developed in Decision Server from a Web- 
based environment and then the role of an IT user to discover how the business rule application was 
built. 

The tutorial is divided into three parts using the modules provided with WebSphere Decision Server as 
shown below. 

Students are advised to progress through these tasks in order. Each task is divided up into steps that 
incrementally build the solution to the scenario described in the next section. Solutions are available at 
certain steps in the tutorial allowing the student to catch up quickly if mistakes are made in earlier tasks. 
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Pre-requisites 


Start Sample Server and the Miniloan web application 

Operational Decision Management provides a sample server to run Decision Center. Before signing in to 
Decision Center, you must start the sample server. 

This tutorial is based on the miniloan-rules rule project that is already deployed to Decision Center. 

The scenario on which the tutorial is based features the web-based application of an online lender. 

To begin, take a look at the Miniloan application in its initial state. 

To start the web application Miniloan and the Decision Center: 

1. Click Start > All Programs > IBM WebSphere Operational Decision Management V7.5 > 
Start Samples Server. 

2. Wait until you see the message build successfull in the console. 


[exec] 

[exec] wsStartSeruer: 

[exec] [startSeruer] profileName=lilODMSample750 registrg=C:\IBM\lilebSphere700 
7\flppSeruer\properties\profileRegistry.xml 

[exec] [startSeruer] profileHome=C:\IBM\lilebSphere7001 7\flppSeruer\profiles\lil 
DMSample75e 
[exec] 

[exec] BUILD SUCCESSFUL 

[exec] Total time: 1 minute seconds 

hecklfIsInstallingDC: 

pdate.decisioncenter.db: 

elete.new.installation.files: 

UILD SUCCESSFUL 

otal time: 1 minute 22 seconds 

ress any key to continue . . . _ 


Note: The server might take a few minutes to start. 

3. Enter the following URL in a browser: 

http://localhost:<PORT>/miniloan-server 
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The Miniloan application is displayed: 



Borrower Information 


I Loan Information 


Name: 

Yearly Income: 

Credit Score; 

Use Rules [71 


Jo@ 


80000 


EOO 


Amount: 

Duration (months): 
Yearly Interest Rate: 


500000 


240 


0.05 


Validate Loan 


4. Make sure the checkbox use rules is selected and click Validate Loan. 
The results of the validation are: 


Borrower Information 


I Loan Information 


Name: 

Yearly Income: 

Credit Score; 

Use Rules [71 


Jo@ 


80000 


EOO 


Amount: 

Duration (months): 
Yearly Interest Rate : 


500000 


240 


0.05 


Validate Loan 


Sorry, the loan has been rejected. 


Debt-to-income ratio is 31% 
Too big Debt-To-Income ratio 


Rules Execution Summary 

4 rule(s) fired 

1: repayment in rule task; miniloan#computation 

2; debt-to-income in rule task; miniloan#computation 

3: repayment and score 4 in rule task; miniloan#eligibility 
4; minimum income in rule task; minilaan#eligibility 

Execution del 

:ails 
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Lab 1 Rules Business Track 

In this lab, you will act as a business user, using Decision Center to write, modify, test, and deploy 
business rules. 

You will first use Decision Center to search for rules in the rule repository. Based on the query results, 
you will edit a rule that determines the minimum credit score required for loan eligibility. You will also 
modify a decision table and then test the rules by using Decision Validation Services. Finally, you will 
learn how to deploy rule applications from Decision Center to Rule Execution Server. 

Pre-requisite: Start the sample server, as described in Start Sample Server and the Miniloan Web 
application, if you have closed it. 


1.1 Manage the business rules 

Business users create and edit business rules in Decision Center. Their work is saved in the central rule 
repository, which manages rule versioning, rule history, and multi-user access. 

This task should take you about 60 minutes to complete. 

• Step 1: Explore the rule project 

• Step 2: Write and run a query 

• Step 3: Modify a rule 

• Step 4: Modify a decision table 

• Step 5: Review the rule history 

• Step 6: Create a smart folder 


1.1.1 Explore the rule project 

In Decision Center, you navigate through your rules in the business user environment. 

To explore the rule project: 

_1. Click Start > All Programs > IBM WebSphere Operational Decision Management V7.5 > 

WebSphere Decision Center V7.5 > Decision Center Console. 

_2. Sign in to Decision Center using the following details: 

Username; rtsuseri 

Password: rtsUserl 

Note: Decision Center can handle different user profiles. Here you sign in as a regular business 
user. 

_3. On the Decision Center Home tab, in the Project In use field, select Miniloan Rules. 
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Welcome to the Decision Center Home Page 

Project in use; Miniloan Rules |-^ 

Branch in use: main 


Current action: | Work upon branch | ^ | 


.4. Click the Explore tab. In the tree view on the left hand, the rules are organized into rule folders, 
and some additional views such as Test Suites. 



5. Under Smart Folders on the left, click the Rule flows folder. 


Smart Folders 


□ Business Rules 

computation 
eligibility i 
validation i 

m Templates 
m Simulations 
m Test Suites 

□ S] Rules by status 
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6. Preview the content of the miniloan ruleflow by clicking the lens 


0 Actions Name 
0 S miniloan 


wi Ruleflow Preview 
Name miniloan 

❖ I I ^ i Si© 



7. Under Business Rules on the left, click the validation folder. 


Smart Folders 

^ 1 © 

E] iS Business Rules 


computation z 


eligibility j 


1 ^ ivalidationi i 


[jJ] Ruleflows 1 


m Templates 


[j] Simulations 


[S] Test Suites 



8. 


Preview the content of the maximum amount rule by clicking (^Preview beside the name of the 
rule in the table to the right. 
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Display by I 1 0 I I 

0 Actions Name Status 

0 . 0 maximum amount New 


Rjle Preview 
Edit 


Name maximum amount 

Status New 

/f 

the amount of 'the loan' is more than 1000000 
f/ie /1 

reject 'the loan' with the reason: "The loan cannot exceed 1,000,000" ; 


9. Click th6 eligibility fold6r. 

.10. Preview the content of the repayment and score decision table. 


Q) Decision Table Preview 
Edit 

Name repayment and score 
Status New 


sf 

the status of 'the loan' is not "Rejected" 


Debt-to-1 nco m e *yb cred it score , „. . 

Loan Status 

min max mm max 

Reason 

1 

0 

30 

0 

200 

Rejected 

debt-to-income too high compared to credit score 

2 

200 

800 

Accepted 


3 

30 

45 

0 

400 

Rejected 

debt-to-income too high compared to credit score 

4 

400 

800 

Accepted 


5 

45 

50 

0 

600 

Rejected 

debt-to-income too high compared to credit score 

G 

7 

600 

800 

Accepted 


OCr/ierwise 

0 

800 

Rejected 

debt-to-income too higti compared to credit score 


1.1.2 Write and run a query 

In your business user role, you are asked to change the allowable debt-to-income ratio from 30% to 40% 
for people who earn less than $50,000. 

Your starting point in Decision Center is to find all the rules in your project that use the yearly income on 
which the debt-to-income ratio is based. 

To write and run a query: 

_1. Make sure you are signed in to Decision Center as rtsUserl and that the Project in use is set 

to Miniloan Rules in the Home Page. 

_2. Click the Query tab, and click New. 
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3. In the Name field, type Uses Yearly Income. 

4. Click [such thst] and select <a rule artifact> uses the value of <a member>. 

5. Click <a rule artifact>, and select each business rule. 

.6. Click <a member>, and build the following statement: 

the yearly income of a borrower 

Your query looks like this: 



_7. Click Save and Run Query. 

The query results show the debt-to-income rule and the minimum income rule. 

_8. To help you evaluate which rules you must change to implement the new policy, click Generate 

Report on Query Results. 

_9. On the Project Report page, click Miniloan Rules to view the report. 

An HTML report is displayed, showing details for all the rules returned by your query. 

By looking at the report, you see that debt-to-income already calculates the debt-to-income 
ratio, therefore only minimum income needs to be changed to implement the policy change. 

_ 10. Close the HTML report, and click the Back button in the Analyze tab, to return to the Query tab. 

1.1.3 Modify a rule 

Now that you have found the rules that need to be modified, you can change the allowable debt-to- 
income ratio from 30% to 40%. 

To change the allowable debt-to-Income ratio: 

_1. In the query results table, select minimum income and then click Quick Edit button beside the 

rule name: 
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Display by | 10 | ^ | 


r~l Actions Name 
I I © debt-to-income 

□ © minimum income 


Status 

New 

New 


Priority 


Last Changed By Last Changed On 
rtsAdmin 12/16/11 11:58 AM 

rtsAdmin 12/16/11 4:08 PM 


_ 2 . The following panel is launched to edit the content of the rule and its properties: 


\ Rule Editing 

B Save I H Cancel 


Name* minimum income 

Status* New 


[definitions] 

if 

the yearly repayment of the loan [±] is more than the yearly income of the borrower * T 0.3 [±] X 

% 

then 

reject the loan with the reason: T Too big Debt-To-Income ratio [±] X 

[else] 


Add a comment to this version 


3. In the if part of the rule, click the value o. 3 to activate the field, and change the value to o. 4. 
Press RETURN to incorporate the change. 

4. Click the ^ blue arrow just above the then keyword and add the following condition: 

and the yearly income of the borrower is less than 50,000 

.5. Change the Status of the rule from New to Defined. 

6. In the Add a comment to this version section, type the following text: 
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Increase the debt-to-income from 30% to 40% for salary below 50,000 


" j Rule Editing 

Save I H Cancel 


Name* minimum incQme| 
Status* Defined ▼ 


[definitions] 

if 

the yearly repayment of the loan [±] is more than the yearly income of the borrower T 0.4 [±] X 
and the yearly income of the borrower [±] is less than T 50000 [±] X 

then 

reject the loan with the reason: T Too big Debt-To-Income ratio [±] X 

[else] 


Add a comment to this version Increase the debt-to-income from 30% to 

40% for salary below 50,000 


_7. Click Save. The new rule details are displayed. 

1.1.4 Modify a decision table 

You are asked to make your lending criteria less restrictive, so that you reject a loan for someone whose 
debt-to-income ratio is between 45 and 50 only if the applicant’s credit score is less than 500. To do this, 
you modify the repayment and score decision table. 

To modify the decision tabie and correct any resuiting errors: 

_1. Click the Expiore tab. Under Business Ruies on the left, click the eligibility folder. 

_2. Preview the content of the repayment and score decision table by clicking T Preview beside 

the name of the rule in the table to the right. 
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Display by 


r~| Actions 

Name 

^ Status 

Priority 

Last Changed B’ La.st Changed On 

1 1 4^ -’-j 

© minimum credit score 

New 


rtsAdmin 

1/4/12 3:53 PM 

□ 4 ' ^ 

© minimum income 

New 


rtsAdmin 

1/4/12 3:53 PM 

0 ^ LiSi te 

repayment and score 

New 


rtsAdmin 

1/4/12 3:53 PM 


3 Results 


Q) Decision Table Preview 
N Edit 

Name repayment and score 
Status New 


if 

the status of 'the loan' is not "Rejected" 


Debt-to-income *Vb credit score , . 

Loan Status 

min max mm max 

Reason 

1 

0 

30 

0 

200 

Rejected 

debt-to-income too high compared to credit score 

2 

200 

800 

Accepted 


3 

30 

45 

0 

400 

Rejected 

debt-to-income too high compared to credit score 

4 

400 

800 

Accepted 


5 

45 

50 

0 

600 

Rejected 

debt-to-income too high compared to credit score 

6 

7 

600 

800 

Accepted 


Otherwise 

0 

800 

Rejected 

debt-to-income too hiqti coimiared to credit score 


3. Click Edit. The following panel is launched to edit the content of the decision table and its 
properties: 


ha Decision Table Editing 
O Save I B Cancel 


Name* repayment and score 
Status* rivJew H 


_ 1 - 7 1 All _ Hi ^i[5i 


Condition editor 


Debt-to-income ratio [±] is at least T 0 [±] and less than T 30 [±] [and/or] 


i Use this editor to edit the selected cell. 



Debt-to-income ®/b 

credit score 

Loan Status 

Reason 


min 

max 

min 

max 

1 

0 

30 

0 

200 

Rejected 

debt-to-income too high compared to credit score 

2 

200 

800 

Accepted 


3 

30 

45 

0 

400 

Rejected 

debt-to-income too high compared to credit score 

4 

400 

800 

Accepted 


5 

45 

50 

0 

600 

Rejected 

debt-to-income too high compared to credit score 

6 

600 

800 

Accepted 


7 

Otherwise 

0 

800 

Rejected 

debt-to-income too high compared to credit score 



4. Click the cell in the max column that contains 600 under credit score. Replace 600 with 
500, and then press ENTER. 
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.5. Notice how a warning is displayed on the column header. This indicates that there is an error. A 
warning message states that Rows have gap(s). 



Debt-to- 

income 9^ 

credit score 


min 

max 

min 

max 

1 


30 

0 

200 

2 

0 

200 

800 

3 

30 

45 

0 

400 

4 

400 

800 

5 

45 

SO 

■j 

0 

500 

6 

600 

800 

7 


0 

800 


6. To solve this problem, click the cell in the min column under credit score containing 600 , and 
replace 600 with 500 , and then press ENTER. The problem disappears. 

7. Change the Status of the rule from New to Defined. 


S Decision Table Editing 
y] Save I S Cancel 

Name* | repayment and score | 

I PGfined I ^ 

°Tg i °is i °is i ^ i HI $ i ; i T _ 1 - 7 1 All _ 


Condition editor 


the credit score of the borrower [±] is at least W 0 [±] and less than ▼ 500 [±] [and/or] 


i Use this editor to edit the selected cell. 



Debt-to-income % 

min max 

credit score 

min max 

Loan Status 

Reason 

1 

0 

30 

0 

200 

Rejected 

debt-to-income too high compared to credit score 

2 

200 

800 

Accepted 


3 

30 

45 

0 

400 

Rejected 

debt-to-income too high compared to credit score 

4 

5 

6 

7 

400 

800 

Accepted 


45 

50 

0 

500 

Rejected 

debt-to-income too high compared to credit score 

500 

800 

Accepted 


Otherwise 

0 

800 

Reiected 

debt-to-income too high compared to credit score 


8. Click Save. 

The new decision table details are displayed. 


1.1.5 Review the decision table history 

Any changes made to a rule are stored in the rule repository, while new versions of a rule are given new 
version numbers. This allows us to compare differences between rule versions, and restore older 
versions if desired. 

In this exercise we will review the decision table history for repayment and score. Now you can 
check the history of the decision table that you modified, and compare the differences between the two 
versions. 


Task 11: Validating 


Page 23 



























































IBM Software 


To review the history of the decision tabie: 

_ 1 . Click History in the toolbar. On the History page, you can see the versions of the decision table 

since its creation. 

_2. Select versions 1.0 and 1.1 , and click Compare 2 Versions to see the changes in the rule 

between these two versions. 


Explore Version Details I ^Compare 2 Versions |ll^ Restore Version | Copy | (?) Help 


Display by | 10 | ▼ | 

■ 

Version 

T Changed By 

Comment 

Date 1 

□ 

1.0 

rtsAdmin 


1/4/12 3:53 PM 

□ 

1.1 

rtsUserl 


1/4/12 6:42 PM 


Each line in the table corresponds to a difference between the versions, in this case a change to 
the status of the rule, and another to its contents. 

3. Click on the Content link in the second row to display the differences between the old and new 
values of the rule content. 


OLD VALUE NEW VALUE 



Debt-to- 
income *Vb 

credit 

score 

Loan 

Status 

Reason 


Debt-to- 
income *Vb 

credit 

score 

Loan 

Status 


min 

max 

min 

max 



min 

max 

min 

max 

1 

0 

30 

0 

200 

Rejected 

debt-to-income too high compared to 
credit score 

1 

0 

30 

0 

200 

Rejected 

debt 

2 



200 

800 

Accepted 


2 



200 

800 

Accepted 


3 

30 

45 

0 

400 

Rejected 

debt-to-income too high compared to 
credit score 

3 

30 

45 

0 

400 

Rejected 

debt 

4 



400 

800 

Accepted 


4 



400 

800 

Accepted 


5 

45 

50 

0 

600 

Rejected 

debt-to-income too high compared to 
credit score 

5 

45 

50 

0 

500 

Rejected 

debt 

6 



600 

800 

Accepted 


6 



500 

800 

Accepted 


7 

Otherwise 

0 

800 

Rejected 

debt-to-income too high compared to 
credit score 

7 

Otherwise 

0 

800 

Rejected 

debt 


Lines that have been modified appear in red. 

Business users can also use Microsoft Excel to edit rules and work offline with the Rule Solutions for 
Office. 


1.1.6 Create a smart folder 

To view all the rules and decision tables contained in the rule project, we will use the Explorer view and 
create a smart folder. 

To create a smart view: 

_1. Click the Explore tab. 
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2 . 


In the Explore toolbar, click the New button to create a new view. 

Smart Folders | -s-iJ || ^ 


□ iBusine^ Ruled 


a 


computation 2 
lD eligibility 3 
lD validation 1 
12] Ruleflows 1 
rS1 Templates 
m Simulations 
m Test Suites 


_3. In the Step 1: Properties, type Rules by status in the Name field. 


Compose 

Step 1: Properties 1 

" 'Properties 

( 

Step 2: Query 

Step 3: Displayed Properties 

Step 4: Documentation 

Step 5: Version Information 

Rules by status 

Include Dependencies 

<none> T. 


4. Click on Step 3: Displayed Properties, select Status in the list of Available Properties, then 
click on the middle arrow to push it to the Displayed Properties. 


Step 1: Properties 
Step 2: Query 


Step 3: Displayed Properties 


step 4: Documentation 
Step 5: Version Information 





Available Properties 
Active 
I Created By 
Created On 
Effective Date 
Expiration Date 
Folder 
■ Group 

I Last Changed By 

Last Changed On 

I Locale 

Name 

Priority 

Project 

Template 


Displayed Properties 


Status 
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5. Click Finish and you will see the new smart folder in the Explore tab. 

Smart Folders 


B 


Business Rules 
computation 
lD eligibility 3 
validation 1 
Ruleflows 1 
[J] Templates 
m Simulations 
nn Test Suites 
U] Rules by status 


O 


□ efinej^ 2 
O Deployable 
O New 4 
O Rejected 
O Validated 


2 


Now, you can see that both rule and decision table you set with the status Defined are listed under 
Defined with the number (2). 

After editing the business logic in Decision Center, you validate the rules to make sure that they behave 
as expected. You will do this in the next task. 


1.2 Validate the rules changes 

In this task, you use Decision Vaiidation Services in Decision Center to run tests and check that 
the ruies execute as expected. 


Decision Validation Services allows you to test a ruleset against typical execution scenarios to check that 
the rules execute as expected. 

In the previous task, you modified the debt-to-income ratio in the minimum income rule and the credit 
score in the repayment and score decision table. In this task, you run the scenarios to check that the 
modified rule behaves as expected. 

You assume the role of business user to create a test suite in Decision Center and run it. 


This task should take you about 20 minutes to complete. 


• Step 1: Create and run a test suite 

• Step 2: Modify the Excel scenario file 

• Step 3: Edit and run the test suite 
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1.2.1 Create and run a test suite 

Now that you’ve modified and created rules in Decision Center, the rules should be tested before they 
are deployed to the production Rule Execution Server environment. The testing and simulation is made 
possible through Decision Validation Services. 

In this exercise you will use Decision Validation Services to test and simulate the rule changes you made 
in the prior exercises. 

To create a test suite: 

_1. Make sure you are signed in to Decision Center as rtsuseri and that the Project in use is set 

to Miniloan Rules in the Home Page. 

_2. Click the Compose tab. 

_3. In the Compose tab, select Test Suite to the left, and then click OK. 

_4. In Step 1: Properties, enter Miniioan Test as name for the test suite, and click Next. 

_5. In Step 2: Rules Tested, keep the default option to test all the rules in the project, and click 

Next. 

_6. In Step 3: Scenarios, click on the blue hyperlink Generate template. A wizard opens. 
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7. Under Expected Results, expand the loan and select the status attribute as we want to test it. 
Then, click on Generate. 

Generate Scenario File Template 

Locale 

Select the display locale: 

Expected Values 

Select the columns to include in the Expected Results sheet and in the Expected Execution Details sheet 


□ Select^Unselect All 

^ ^3 Expected Results 

^ ^3 the loan 

□ amount 


□ duration 


□ messages 


1 S status 1 


□ yearly interest rate 


□ yearly repayment 


^ n ^3 Expected Execution Details 

□ The list of rules fired 


□ The list of executed ruleflow tasks 


□ The duration (in ms) of execution 


Generate | Cancel ] 


8 . Click the generated template. xis to save it. The Excel file will be saved by default on the 
Desktop. 



Note: Make sure to save it. Otherwise, opening it will save the excel file in a temporary folder 
and will open it in Read-Only mode instead. 
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.9. Open the saved Excel file. Fill in the scenario file template as follows: 


a) Scenarios sheet: 




the borrower 

the loan 

Scenario ID 

description 

credit score 

name 

yearly income 

amount 

duration 

yearly interest rate 

1 rejected loan 


600 

Joe 

soooo 

500000 

240 

0.05 

2 accepted loan 


600 

Joe 

soooo 

250000 

240 

0.05 


Scenarios j/ Expected Results XhELP /^/ 

Note: To add rows, copy and paste the first one. 

b) Copy/paste the scenarios ID between the worksheet Scenarios and Expected Results to 
make sure the ID are the same between both worksheets. This should look like this: 



E!S!fiWfBili*BMii|the status of the loan equals 



1 rejected loan | Rejected 

■w 

2 accepted loan llAocepted 






Scenarios Expected Results HELP ^ 


10. Save the file. 

11. Go back to Decision Center, click on Back button. 

12. In Step 3: Scenarios, click Browse in the File section, and select Desktop/template .xis to 
upload the scenario file you created. You should see the message: File Uploaded 

Scenarios 

f'ormat: | Excel (2003) 

Generate template: Generate a scenario file t 
upload below when finished 

File: template.xls (File uploaded) 

I Browse... | 

13. Click Finish and Run. 

14. On the Run page, make sure the check box The list of rules fired is selected, and 
click Run. 
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Run Miniloan Test - Version: 1.0 

Server: | Rule Server I I 
Report Options: 

Name PMinilQan Test - Report | 

□ Create an Excel file separate from the report to store the output values 

In addition to any tests specified in the scenario file, you can add in the report: 
[7| The list of rules fired 

□ The list of executed ruleflow tasks 

□ The duration (in ms) of execution 

[ Cancel ] [ Run ] 


Decision Center may take a few seconds to complete this action. 

The report opens and shows the results of the tests and the list of rules executed: 


Summary 



Number of scenarios 

2 


Scenarios with failures 

n 


Success Rate 






Details 



Name 

Status 


E 0 1 rejected loan 




Status Test 

Message 


® the status of the The observed value "Accepted" does not equal the 


loan equals 

expected value "Rejected" 


The list of rules fired 

computation.repayment 

CO m p utati on.de bt-to -i nco m e 
eligibility.repayment and score 4 

S 2 accepted loan 




Status Test 

Message 


® the status of the loan The observed value "Accepted" is the expected 


equals 

value 


The list of rules fired 

CO m p utati o n. re p ay m e nt 

CO m p utati on.de bt-to -i nco m e 
eligibility.repayment and score 2 


Scenario 1 fails because it expects the loan to be rejected. However, the loan is now approved 
because you have increased the allowable debt-to-income ratio in the minimum income rule. 
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1.2.2 Modify the Excel scenario file 

To correct the problem in Scenario 1, you edit miniioan-test.xls and modify the expected results 
for Scenario 1 . You also add a new scenario to verify that the loan is rejected if the debt-to-income ratio 
is too high. 


.1. Open Desktop/template. xls. 

. 2 . Click the Expected Resuits tab, and change the scenario ID and the expected result for 

Scenario 1 to Accepted. 


Scenario ID 

the status of the loan equals 

1 accepted loan 

Accepted 

2 accepted loan 

Accepted 


Scenarios 


Expected 


Results /HELP /tj/ 


.3. Click the Scenarios tab, copy and paste the Scenario 1 row, to create a third scenario and 
change the yearly income to 4 0000. You can also update the description as follows: 




the borrower 

the loan 

Scenario ID 

description 

1 

credit score 

1 

name 

1 

yearly income 

amount 

duration 

1 

yearly interest rate 

1 accepted loan 


600 

Joe 

80000 

500000 

240 

0.05 

2 accepted loan 


600 

Joe 

80000 

250000 

240 

0.05 

3 rejected loan 


600 

Joe 

40000 

500000 

240 

0.05 


_ I 

Scenarios ’ Expected Results /HELP /?J/ 


4. Click the Expected Results tab, add a new row for Scenario 3, and enter Re j ected as 
expected result. 



Scenario ID 

the status of the loan equals 1 


1 accepted loan 

Accepted I 


2 accepted loan 

Accepted | 


3 rejected loan 

Rejected f 




Scenarios J Expected 

Results /HELP /O/ 


.5. Save the changes and close the file. 


1.2.3 Edit and run the test suite 

To test the scenarios that you modified, you must edit the test suite and run it again. 

_1. Make sure you are signed in to Decision Center as rtsuseri and that the Project in use is set 

to Miniloan Rules. 
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2. Click the Explore tab, and click Test Suites to the left. 

.3. Next to the Miniloan Test suite, cNck QuIck Edit as follows: 

[3 Ac tions Name .*■ Last Changed By 

0 □_ m Miniloan Test rtsAdmin 

4. In File section, click Choose File to upload the updated excel scenario. 

hs Test Suite Editing 
El Save I B Cancel 

Name* jMiniloan Test 


^ By default all rules of the current branch will be tested 
^ Or you can test: 

rules from a baseline of this branch: | main ^1 
rules selected from: | <none> ^1 
For this ruleset, the entry point is: |<default> (miniloan) 




■^ormat: | Excel (2003) _iJ 

Generate template: Generate a scenario file template for this test suite that 


File: template.xls (If you edit this die do not forget to upload it below when finished) 

I Browse... | 


.5. Select the Desktop/template. xis to upload the scenario file that you modified, and make it 
available to Decision Center. 

6. Click Save and click on Run button as follows: 

[/I Action s Name ^ Last Changed By 

0 Miniloan Test rtsAdmin 

7. On the Run page, make sure the check box The list of rules fired is selected, and 
click Run. 
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Run Miniloan Test - Version: 1.3 


Server: | Sample I ■»■] 

Report Options: 

Name PMinilQan Test - Report | 

□ Create an Excel file separate from the report to store the output values 

In addition to any tests specified in the scenario file, you can add in the 
report: 

[7| The list of rules fired 

□ The list of executed ruleflow tasks 

□ The duration (in ms) of execution 

[ Cancel ] [ Run ] 


The report opens, the tests of the three scenarios are successful: the expected results match the 
execution results. 

Details 

Name Status 

El 1 loan 

@ 2 loan 

Q 3 loan 


Status Test Message 

@ the status of the loan equals The observed value "Rejected" is the expected value 

The list of rules fired computation.repayment 

CO m p utati on.de bt-to - i nco m e 
eligibility.repayment and score 7 


If you expand the third scenario, you notice that the row 7 of the decision table repayment and 
score was executed. You can click on this hyperlink to open the decision table. 

After testing the ruleset in Decision Center, users with the appropriate role can deploy the changes to 
Rule Execution Server. You will do this in the next task. 


1.3 Deploy the rules 

In this task, you deploy your ruleset directly from Decision Center to Rule Execution Server. 


Users with the correct access rights can deploy rulesets directly from Decision Center. 

You can deploy both from Rule Designer and Decision Center. You will create a RuleApp, a container for 
your ruleset, and deployed the RuleApp to Rule Execution Server so that it could be executed. 
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In this task you will do the same thing from Decision Center, and then see how the new rules affect the 
Miniloan application. 

'^This task should take you about 20 minutes to complete. 

• Step 1: Deploy the rules 

• Step 2: See the effects in the Miniloan application 
1.3.1 Deploy the rules 

Because some of the rules were already deployed, you will increment the RuleApp version. Later you 
will see how Rule Execution Server manages these changes. 

You will now deploy the rules to the Rule Execution Server. Because some rules may have already been 
deployed, you will increment the ruleapp version. 

To deploy the RuleApp: 

_1. If you are not logged to Decision Center, login using the following credentials: 

Username; rtsuseri 

Password: rtsUserl 

_2. In the Decision Center Home page, change the Project in use to Miniioan Rules. 

_3. Click the Project tab, and then click Deploy RuleApps. 

_4. Under Available RuleApps, select the RuleApp MiniloanRuleapp. 

Available RuleApps 

Details I "^Deploy I ^^Redeploy] §lRefresh| @Help 
Display by 


Name Display Name Major Minor 


[3 MiniloanRuleApp 1 0 

5. Click ''^Deploy in the toolbar. 
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6. In the Deployment Baseline, type ITERATION 1, and then click Next. 

Deployment Baseline 

|7 Create a baseline for this deployment | ITERATION 1 
Cancel | Previous | Next | 

This creates a deployment baseline called ITERATION 1, that is, a snapshot in Decision Center 
of the version of each element about to be deployed. A baseline captures the changes that occur 
in a project over time, and allows you to revert back to one of the rules if required. 

7. On the RuleApp target page, select Deploy on a Rule Execution Server, and then click Next. 

8. On the Versioning Policy page, keep the default Increment RuleApp major version. 

Versioning Policy 

pgnncremGn^uIeAp^Tiajo^G^io^n 

0 Replace RuleApp version 
0 Increment ruleset(s) major version 
0 Increment ruleset(s) minor version 
0. Replace ruleset(s) version 

[ Cancel ] [ Previous ] [ Next ] 

This increments the RuleApp version to 2.0 if one ruleapp was already deployed. 

9. Click Next. 

10. On the Server List page, select the Rule Server. 

11 . Click Deploy. 

When processing is complete, you see the Deployment succeeded message. 
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Deployment Succeeded 


RuleApp archive deployed 
Versioning Policy 
Rule Execution Server 


MiniloanRuleApp 

Increment RuleApp major version 
http ://localhost: 9081/res 



^ /MiniloanRuleApp/1.0 * Version changed and element added /MiniloanRuleApp/3.0 
/MiniloanRules/1.0 Version changed and element added Si /MiniloanRules/1.0 


List of deployment baselines created 



ITERATION 1 


Miniloan Rules 


MiniloanRuleApp 


MiniloanRules 


_12. Sign out of Decision Center. 

1.3.2 See the effects in the Miniloan application 

Finally, you will see how the business policy changes you made are reflected back into the Miniloan 
application. 

To see the effects in Miniloan; 

_1. Start Miniloan by entering the following URL in a browser: 

http://localhost:<PORT>/miniloan-server 
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2. In Miniloan, make sure to check the option Use Rules and click Validate Loan with the default 
values. 



Borrower Information 


I Loan Information 


Name: 

Yearly Income: 

Credit Score: 

Use Rules [71 


Jo 0 

Amount; 

80000 

Duration {months}; 

600 

Yearly Interest Rate; 


500000 


240 


0.05 


Validate Loan 


Congratulations! The loan is approved. 


Debt-to-income ratio is 31% 
Yearly repayment is $25,250 


Rules Execution Summary 

3 rule(s)fired 

1; repayment in rule task; miniloan#computation 

2: debt-to-income in rule task: miniloan#computation 

3; repayment and score 4 in rule task; miniloan#eligibility 

Execution del 

:ails 


The loan is not rejected any more because we added a new condition in the minimum account 
rule to verify whether the minimum income for borrowers is less than 500,000. 

.3. You can use Decision Warehouse to access the execution details for a decision and view the 
rules that were fired in the Rule Execution Server. To do so, click on the hyperlink Execution 
Details. 

.4. The console of Rule Execution Server will open in a new tab. Login using the following 
credentials: 

Username; resAdmin 
Password; resAdmin 

5. The Home page of the console opens. If you click again on the hyperlink of the result page, then 
it will open the Execution Details as follows: 
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^Execution Details 

795009d7-2 d9c-4989-b c77-a5aS4abc65d9 
2012-01-04 19:07:55 
/ M in iloa n Ru le Ap p/ 2.0/ M in iloa n Ru les/1.0 
154 

3 

4 


Decision ID: 

Date: 

Executed ruleset path: 
Processing Tinie {ms} 
Number of rules fired 
Number of tasks execute 


Decision Trace 

□ ,11, Ruleflow Tasks (1) 

□ 0 miniloan (3) 

0 miniloan > validation 
E 0 miniloan >computation (2) 

a computation. repayment 
0 computation.debt-to-income 
□ 0 miniloan >eligibility (1) 

0 eligibility.repayment and score 4 


Input Parameters 

loan : 


By expanding the tree view of the Ruleflow Tasks, you can see the path and the rules executed 
to make the decision. 

Each rule is displayed as a hyperlink to allow you to access the rule content. When the rule is 
actually a decision table, a number is displayed at the end of the rule name to indicate which row 
was executed. 

6. Click on the decision table eligibility. repayment and score 4. This will open the 
following screen: 


Table 

if 

the status of 'the loan’ is not "Rejected" 


Debt-to-income credit score , . 

Loan Status 

min max mm max 

Reason 

1 

0 

30 

0 

200 

Rejected 

debt-to-income too high compared to credit score 

2 

200 

800 

Accepted 


3 

30 

45 

0 

400 

Rejected 

d e bt-to - i nco m e to o h i g h co m pa re d to ere d it sco re 

4 

400 

800 

Accepted 


5 

45 

50 

0 

600 

Rejected 

debt-to-income too high compared to credit score 

6 

7 

600 

800 

Accepted 



0 

800 

Rejected 

debt-to-income too high compared to credit score 


You have now deployed your ruleset to Rule Execution Server and see the effects on the web 
application while auditing which decision was made. 
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1.4 Author in Rule Solutions for Office (Optional) 

In this task, you use Rule Solutions for Office to edit rules using the Microsoft Office. 

You can edit business rules directly in Decision Center, but you can also use Rule Solutions for Office to 
edit rules offline with the Microsoft Office tools that you are already familiar with. 

In this task, you edit and action rule and a decision table, and then you update the changes in Decision 
Center. 

Note: This task is optional. To do this task, you must have Rule Solutions for Office installed. 


^This task should take you about 20 minutes to complete. 


• Step 1: Modify an action rule in RuleDocs 

• Step 2: Modify a decision table in a RuleDocs 


1.4.1 Modify an action rule in RuleDocs 


First, you will edit a rule. Because some of the rules were already deployed, you will increment the 
RuleApp version to 1.1. 

_1. In Smart Folders, click the eligibility folder and, then select the minimum credit 

score rule. 


Smart Folders 


^ I m 


Business Rules > eligibility 


□ [jJ] Business Rules 

computation z 
eligibility 3 
validation i 
m Ruleflows 1 
[J] Templates 
[J] Simulations 
[J] Test Suites 


New I Details I ^ Edit I X Delete I I 

Display by \Mz] 

I I Actions Name 

0 1 *>1 ^ © minimum credit score 

I I ^ © minimum income 

I I i ffi repayment and score 


2. Click on the Edit in Rule Solutions for Office icon to open the rule in Word. 

I I Actions Name 
0 Jil ® minimum credit score 

I I ^ c5b © minimum income 
EH .ij Sa ^ ffi repayment and score 


3. A Word document called minimum credit score. docx will be saved temporarily on your 
machine. Open this document. 
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4. If the RuleDoc pane is not visible, on the Rule tab, in the View group, click RuleDoc Pane to 
display it. 


Home 


Insert Page Layout References Mailings 


Review 


View 


Rules 




O Completion Menu 

0 Sentence Completion 


u 

^ L: j 



M 

t.i 


Check 

Discard 

Check 

Highlight 

Set as Default Apply Default Insert Rule 

RuleDoc 

Vocabulary 

Save Text to 

Options 

In 

Check-Out 


Syntax 

Syntax 

Rule Format Rule Format Propert>^ 


Pane 

Pane 

Rule Gallery^ 

- 

Decision Center 

Write 

Review 

Format 


View 

Content 

Customize 


5. In the rule, replace both values 200 of the credit score with 300. 


minimum credit score 

Package: eligibility 

the credit score of 'the borrower' is less than 300 

their 

reject 'the loan' with the reason; "Credit score below 300" ; 

6. On the Rule tab, in the View group, click the Vocabulary Pane to display the full business object 
model. 

7. Close the document. Then, answer Yes to “Do you want to check in now?” 



When asked to enter a password, type: rtsUseri. 
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Finally, you can enter a comment to this version as follows: 



The temporary copy will be removed from the draft folder. 



1.4.2 Modify a decision table in RuleDocs 

You are asked to make your lending criteria more restrictive, so that you reject a loan for someone 
whose debt-to-income ratio is between 0 and 30 only if the applicant’s credit score is less than 300. To 
do this, you modify the repayment and score decision table. 

To modify a decision tabie and correct any resuiting errors: 
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1. In Smart Folders, click the eligibility folder and, then select the decision table repayment 
and score rule. 


Smart Folders 


«] I © 


Business Rules > eligibility 


Q U] Business Rules 

computation z 
iJU eligibility j 
validation i 
Ruleflows 1 
[J] Templates 
[J] Simulations 
m Test Suites 


New I Details I \ Edit I K Delete I 


Display by 


r~| Actions Name 

□ ^ © minimum credit score 

r~l 'Ci ^ © minimum income 

; [3 ; Ct ^ B. ffi repayment and score 


2. Click on the Edit in Rule Solutions for Office icon to open the rule in Excel. 


□ 

0 

□ 

□ 


Actions Name 

Jb s: © minimum credit score 
-i) ^ @_ © minimum income 

I ffi repayment and score 


3. A Word document called repayment and score. xisx will be saved temporarily on your 
machine. Windows will propose to “Open with” or “Save” this document, open this document by 
selecting Open with. 



.4. If the RuleDoc pane is not visible, on the Rule tab, in the View group, click RuleDoc Pane to 
display it. 


1 Home 

Insert 

Page Layout 

Formulas 

Data 

Review 

View 

Add-Ins 1 


Decision Table 


a ^ i- 

Check Discard Insert 

In Check-Out > 
Decision Center 



Delete 


Column Expression 
Edit Bar 


Write 


Check 
for Gaps 

Check for 
Overlap 

EaM 

RuleDoc 

Pane 

Review 



e B \ 


Preconditions Rule Vocabulary Options 
Statements Pane . 

View 
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5. Under credit score, click the cell in the max column that contains 200. Replace 200 with 300, and 
then press Enter. 


Debt-to-income % 

1 credit score 

Loan Status 

Reason 

min 

max 

min 

max 



0 

30 

0 

300 

Rejected 

debt-to-income too high comparei 

200 

SOO 

Accepted 


30 

45 

0 

400 

Rejected 

debt-to-income too high comparei 

400 

SOO 

Accepted 


45 

50 

0 

600 

Rejected 

debt-to-income too high comparei 

600 

SOO 

Accepted 


Otherwise 

0 

SOO 

Rejected 

debt-to-income too high comparei 


Notice how some cells have a yellow background. This indicates that there is an error. In the Problem 
List in the RuleDoc pane, you can see exactly what the error is: Rows have overlapping values. 

_6. To solve this problem, click the cell in the min column under credit score containing 200, and 

replace 200 with 300, and then press Enter. 

The problem is no longer displayed in the Problem List in the RuleDoc pane. 

_7. Close the document. Then, answer Yes to “Do you want to check in now?” 



When asked to enter a password, type: rtsUseri. 



Finally, leave the comment to this version empty and click Ok: 
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The temporary copy will be removed from the draft folder. 



You are now familiar with Rule Solutions for Office to edit rules offline with the Microsoft Office tools. 


Summary 

In this lab you used Decision Center to perform the following business analyst tasks: 

• Created and executed a rule query. 

• Edited a rule and compared different rule versions. 

• Created a new rule. 

• Tested and simulated the rules by leveraging Decision Validation Services. 

• Created a new RuleApp and deployed it to Rule Execution Server. 
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Lab 2 Rules Technical Track 

In this lab you will create a rule project for the Miniloan application. The Miniloan Rules project which will 
contain business rules that will manage loan requests from borrowers. The rules will validate the loan, 
compute the debt-to-income, and finally determine the eligibility of the loan. 

You will assume the role of a rule developer by using Rule Designer, an Eclipse-based development 
environment, to develop your rule application. In this detailed lab you will create a rule project, business 
object model, and necessary business rules. Finally, you will deploy the rule application to Rule 
Execution Server and Decision Center. 

Pre-requisite: Start the sample server, as described in Start Sample Server and the Miniloan 
Web application, if you have closed it. 


2.1 Designing a ruie project in Rule Designer 

In this task, you will use Rule Designer to create a rule vocabulary that enables business users to write 
rules using terms that are meaningful to them. This vocabulary is created directly from the object model 
of the existing Miniloan application. 


Business users need to write and edit rules using familiar terms. As the rule project developer, you must 
create a rule project and business rule vocabulary for them. The process of creating this business rule 
vocabulary is called “verbalization”. You create a Business Object Model (BOM) based on an execution 
Object Model (XOM) defined in XML schema. The classes and members of the BOM map to the terms 
and phrases familiar to the business user, as follows: 


Business Rule 


Business Object Model 



Phrase _][_ 

{credit score} of {this} 


0 


Borrower 


creditScore 


verbalize 
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This task should take you about 40 minutes to complete. 

• Step 1: Launch Rule Designer 

• Step 2: Create a rule project 

• Step 3: Define the execution Object Model (XOM) from the XML schema 

• Step 4: Create the Business Object Model (BOM) 

• Step 5: Add a business method to the Loan Class 

• Step 6: Define the service interface with ruleset parameters 


2.1.1 Launch Rule Designer 

Developers leverage Rule Designer for authoring and managing business rule applications. Since Rule 
Designer is based on Eclipse technology, developers can quickly familiarize themselves with the platform 
and leverage this integration to develop their Java projects, in addition to rule projects. 

You will use Rule Designer for the majority of the technical activities in this tutorial. 

To launch Rule Designer: 

_1. Start Rule Designer from the Desktop. 

_2. The Workspace Launcher dialog shows your default workspace. Make sure to have the 

workspace name equals to c : \gettingstarted\workspace and click OK. 

This workspace does not contain any projects when you start. 

Note: If you do not see the Workspace Launcher dialog when launching Rule Designer, change 
the workspace by clicking File > Switch Workspace. 

_3. Rule Designer opens in the Rule perspective. Close the Welcome view if it is present. 





The Rule perspective contains various views that you will see as you work your way through the different 
tasks. 


2.1.2 Create a rule project 

In Rule Designer the business logic for your application is contained in a rule project. A rule project 
enables you to build, manage, and test the artifacts that comprise the business logic of your application. 

The object model of Miniloan is composed of two main entities, one for the borrower and one for the 
loan. 

To create the rule project: 
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_1. Click File > New > Rule Project to create a new Rule Project. 

_2. The New Rule Project window appears. Select Standard Rule Project and click Next. 

_3. In the Project name field type Miniloan Rules. Click Finish. 

The Miniloan Rules project appears in the Rule Explorer and Rule Project Map. 

^- 

ifg- Rule Explore r ^ .. 

^ ^ I 

^ & Miniloan Rules 
rules 
& bom 
queries 
© resources 
& templates 


The Rule Explorer view shows all of the rule projects that exist in the current workspace. By default the 
rule project contains empty folders. During the tutorial you will use the rules and bom folders to store 
the business rules and business object model (BOM), respectively. 


Rule Project Map £3 ’ 

Mlniloan Rules (& Qwarnings / Q O Errors ) 



The Rule Project Map guides you through the different steps of setting up a rule project, creating rules, 
and deploying them to the runtime server. This tool is great for users who are new to Rule Designer. 

Note: If the Rule Project Map is not displayed, click Window > Show View > Rule Project Map 
to open it. Make sure to select the rule project in the Rule Explorer. 
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2.1.3 Define the execution Object Model (XOM) from the XML schema 

Now that you have an empty rule project, you can use the Rule Project Map to guide you through the 
steps of building the rule application. 

The first thing your rule project needs is the data model that is provided by the Miniloan XML schema. 
This referred to as the execution Object Model (XOM). 

Note: Alternatively, you can use a Java project for the execution object model. 


To import the schema XOM into your ruie project: 


.1. Copy the MiniloanSchema . xsd from the C : \gettingstarted\rules\solutions 

directory into the Miniloan Rules project. You can do this by dragging and dropping it into 

your Miniloan Rules project root folder. 

ffj Rule Explore r,£3 X' _ 

I 

& Miniloan Rules 
rules 
<3 bom 
3 queries 
© resources 
3 templates 
i® MiniloanSchema.xsdi 


The MiniloanSchema. xsd is added to your project in the Rule Explorer. 


2. In the Rule Explorer, double-click the MiniloanSchema . xsd file under Miniloan Rules 
project, and take the time to look at it. By clicking the Design tab at the bottom of the panel, you 
can view the different entities in a graphical view. You can also double-click on each type Loan 
and Borrower to inspect their attributes. 


H Miniloan5chema.xsd E3\. 


1 Miniloan Rules/MiniloanSchema.xsd 


\i\ Schema : miniloan 





Directives 



(©Elements 

©Types 

[H borrower : Borrower 

\M\ loan : Loan 

[E Borrower 

[E Loan 

Design Source 
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3. In the Rule Explorer, click the Miniloan Rules project to select it. 

The Rule Project Map outlines the steps to follow to design your rule project. 
.4. In the Design part of the Rule Project Map, click Import XOM. 

Rule Project Map £3^ 

Minil oan Ru I es (i& o wamingd / o Q Errors ) 


-\ 


Design 




^ Import XOM 

@ 


Orchestrate 

6S Create BOM 

@ 

-► 

Add rule package @ 

Define parameters 

@ 


H Add rufeffow @ 

S§ Check project for testing @ 

__-___ } 



5. In the Import Execution Object Model dialog select Dynamic Execution Object Model (XSD) 
and click OK. 



6. In the Dynamic Execution Object Model page select Add XSD... 



7. Expand Miniloan Rules and select MiniloanSchema. xsd. Click OK. 

8. The Dynamic Bindings view shows that you added a XML schema file. 

Required dynamic binding files: 

^ B MiniioanSchema.xsd - Miniloan Rules 
0 Namespace: miniloan 
ffl Package: miniloan 
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_9. Click OK. 

The Rule Project Map now indicates that you have one XOM in your rule project. 
Rule Project Map £3 

Mlniloan Rules (& Qwarnings / Q O Errors ) 


Design 

> 

^ Import XOM (1) 

© 

6S Create BOM 

© 

■#1 Define parameters 

© 

01 Check project for testing @ 

V_ 

_ / 



2.1.4 Create the Business Object Model (BOM) 

Before you create and edit rules you need to define a Business Object Model (BOM). You can create a 
BOM from scratch or create it automatically by parsing your execution object model (XOM). 

Here you will use Rule Designer to automatically parse the types and elements in the XOM and create 
the BOM from their properties. You will then be able to write rules from the vocabulary terms contained 
in the BOM. 

To create a BOM from the XOM: 

_1. In the Design part of the Rule Project Map click Create BOM. (Alternatively, you can right-click 

the bom folder in the Rule Explorer and click New > BOM Entry.) 


2. From the BOM Entry page enter the BOM details. 

_a. In Name field of the New BOM Entry wizard type miniloan. 

_b. Make sure that Create a BOM entry from a XOM is selected. 

c. Leave the other fields at their default values. Click Next. 


Orchestrate 


® Add rule package © 
K Add ruleflow © 


Design 


^ Import XOM (1) 

© 

@S Create BOM 

© 

‘^i Define parameters 

© 

@8 Check proiect for testing @ 

\_ 

_ J 
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BOM folder: /Miniloan Rules/bom 

Folder: 

Name: miniloanj 

@ Create a BOM entry from a XOM 
O Create an empty BOM entry 

3. In the Choose a XOM entry field, click Browse XOM... Select MiniioanSchema. xsd and click 

OK. 

4. Under Select classes click the checkbox next to the miniloan package. This will select all of 
the classes in the package. 


Choose a XOM entry: 


xom:/Mtniloan Rules//Miniloan Rules/MiniloanSchema.xsd 


Select classes: 


Browse XOM... 


Load XOM 


^ miniloan 

Borrower 
|i^0 Loan 

|f^0 Loan$StatusType 


Select All 


Deselect All 


S Load getters and setters as attributes 


.5. Under the miniloan package, you can see the two main classes Borrower and Loan, plus the 
Loan$statusType which maps the XML enumeration. 

6. Click Next. 

7. In the BOM Verbalization page, keep the default settings, and click Finish. 

Select the elements to verbalize. 

Verbalize: 1^ Getters Setters O All Methods 0 Static References 

mffl miniloan 
m0 Loan 
go Borrower 

8. In the Rule Explorer, the bom folder under the Miniloan Rules project now contains the 
miniloan BOM entry. Double-click miniloan to open the BOM Editor. 
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Q- 


miniloan 


® bom 

a-ssT 

S" 0 miniloai^ 
queries 
^ templates 

Miniloan5chema.xsd 




You now have in your BOM two classes equivalent to those in the XOM, that is, one for the 
borrower and one for the loan. 


6s miniloan £3 \ 


BOM Eri. 


Miniloan Rules/bom/miniloan.bom j 

» j. . . .^- * 


Tasks 


i Verbalize the elements of this BOM entry. i Create add and remove methods 

i Update the dynamic domains of this BOM entry. 

Business Object Model Entry 

^ 6S BOM Entry: miniloan 
^ ffl miniloan 
Q Borrower 
t> © Loan 
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9. In the top right corner of the BOM Entry editor, click the hyperlink Create add and remove 
methods. In the Collection Methods window, expand miniloan > Loan and make sure 

messagesList is selected. 


^ Collection Methods 


Collections 

Select the attributes which you want to create methods. 


Select the attributes. 




B 1^01 

Loan 

0 « messagesList 


Note: An XML element of type Collection (maxOccurs="unbounded") will be appended with List. 
Here, the XML element messages in the XML schema file becomes messagesList in the BOM. 

1 0. Click Finish and Save you work 

11. Let’s look at the verbalization which was generated. Double-click the Loan class to open it in the 
BOM editor. 

12. In the Members section, double-click the addToMessagesList method that was generated when 
creating add method for collection type. 

In the Member Verbalization section, you can see that the verbalization of this method: 

add a string to the messages of a loan 

, and will appear as such in the Rule Editor: 


M em ber Verba bza tk>n 
X Remove the verbalization. 

+ Create an action phrase. 


▼ Action : ''add a string to the messages of a loan" 


Template: add {0} to the messages of {this} 


In the BOM to XOM Mapping section at the bottom, you can see that the implementation of this 
method, and will appear as such in the Rule Editor: 
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▼ BOM to XOM Mapping 

Edit the mapping between this BOM member and the XOM. 
^ Edit the imports. 

Body 

this .inessagesList. add (augument) ; 


2.1.5 Add a business method to the Loan class 

When creating a BOM vocabulary, the default parameters and operations that are generated 
automatically from the XOM are sometimes unsuitable for business users. You can modify the 
generated vocabulary, as well as create new business methods and members to leverage additional 
features for the business user. 

In the miniloan BOM generated from an XML schema there are no operations or verbs, so in this step 
you will create a business method to “reject” a loan. Add a method to the Loan BOM class: 

_1. In the Package tab of the BOM editor, expand the miniioan folder and double-click the Loan 

class. 


Business Object Model Entry 


^ 6S BOM Entry: miniloan 
^ ffl miniloan 
0 Borrower 
0 Loan 


Package 


Class 


Member 


miniloar 


2. In the Members pane click New... 



.3. A new window appears. Create the reject method. 

_a. In the Type panel at the top select Method. 

_b. Type reject in the Name field. 
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c. Type void in the Type field (you can also Browse... for a type). 

d. Click Add... to create an argument. 

_e. Type message in the Name field. 

f. Type j ava . lang. String in the Type field. 

g. The member should look like the following. Click Finish when you are done. 

Type 

O Attri b ute O Con structo r 'O- M etho d 


Name: reject 


Type: void 


Name 

Type 

Domain 

[ message 

java.lang.String 

.j 


4. This new method now appears in the list of members of the Loan class. As this method is 
virtual, an implementation is required. Double-click the reject (string) member. 


Members 

Specify the members of this class. 

o ye a rlyRe payment 
rfloanO 

© addToMessagesList(String) 
j © reject(String) ^ 

5. In the Member Verbalization pane, click the hyperlink Create a default verbalization. 

Member Verbalization 

& This member is not verbalized. Create a default verbalization. 

. 6 . Edit the Template field to have the following phrase: 

reject {this} with the reason: {0^ <message>} 

Action : "reject a loan with the reason: <message>" 

^ - i — 

Template: reject {this} with the reason: {0, <message >}| 

7. Scroll down to the BOM to XOM Mapping panel, and type the following implementation for this 
method: 
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this.status = "Rejected"; 
this.messagesList.add(message); 


Edit the mapping between this BOM member and the XOM. 
^ Edit the imports. 

Body 

this.status = "Rejected"; 
this.messagesList.add (message) ; 


8. From the File menu select Save All. 


2.1.6 Define the service interface with ruieset parameters 

A ruieset contains a set of rules that can be executed at runtime by the rule runtime. Ruieset parameters 
define the interface to the ruieset, as they define the input and output data used by the rules when 
making a decision. Rules can then use these parameters as variables, which conform to the vocabulary 
defined in the BOM for the ruieset. 

To enable a decision to be made on the status of a loan, you need to create parameters for the borrower, 
loan, and loan messages. The borrower must be an IN parameter, meaning it is provided as input to the 
ruieset on execution. The loan must be an IN OUT parameter, meaning it is provided as input to the 
ruieset on execution, but also can be modified by the ruieset and provided as output at execution 
completion. 

To declare ruieset parameters: 

_1. In the Design section of the Rule Project Map, click Define parameters. 


. 2 . To define the borrower parameter click Add... on the right side of the screen. 

A new row appears with default values. Change the values as follows: 

_a. In the Name column type borrower. 

_b. In the Type column click within the type field, then click the ... button to display the 

Types dialog, and choose the Borrower type in the Matching types box. 

Borrower appears in the Type column. 


Orchestrate 

Add rule package @ 
Add ruleflow @ 


Design 

> 

^ Import XOM (I) 

@ 

6S Create BOM (1) 

© 

■#1 Define parameters 

© 

0§ Check project for testing ® 

__-_y 
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c. In the Direction column click within the field and select the IN direction. 

d. In the Verbalization column type the borrower. 

e. Leave the Default Value field blank. When finished, the borrower parameter should look 
like this: 


Define ruleset parameters. 


Name 

Type 

Direction 

DeFault Value 

Verbalization 

borrower 

miniloan. Borrower 

IN 


the borrower 


2. As you did with the borrower parameter, to define the loan parameter click Add... 

A new row appears with default values, change the values as follows: 

_a. In the Name column type loan. 

_b. In the Type column click the ... button to display the Types dialog, and choose the Loan 

type in the Matching types box. 

Loan appears in the Type column. 

_c. In the Direction column keep the default IN_OUT direction. 

_d. In the Verbalization column type the loan. 

.3. Your two ruleset parameters should appear as follows: 


Define ruleset parameters. 


Name 

Type 

Direction 

Default Val... Verbalization 

borrower 

miniloan.Borrower 

IN 

the borrower 

loan 

miniloan.Loan 

IN_OUT 

the loan 


_4. Click OK to save the ruleset parameters. Notice that the Rule Project Map now shows two 

parameters. 

Thus far, you have created a rule project, an object model with a vocabulary, and ruleset parameters. 
The interface and design portion of your rule project is complete. 

Before writing the actual rules in Rule Designer, in the next task you will organize your rules in rule 
packages and orchestrate the rule logic in a ruleflow diagram. 


2.2 Organizing and orchestrating rules 

In this task, you will use Rule Designer to orchestrate rule execution using a ruleflow. 
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To specify the order in which rules are executed you must create a ruleflow. A ruleflow is a way to 
organize the sequence in which rules are processed by the rule engine. 


Rule Projects 


Business Rules 


Technical Rules 


Vocabulary 


% 


BOM 


BOM to XOM Mapping 



Ruleflow 


I IN lOUl 
Rultset 
Parameters 


Ruieiet 



XOM 




IN IN 



^^ This task should take you about 20 minutes to complete. 

• Step 1: Create rule packages 

• Step 2: Create the ruleflow 

• Step 3: Define the ruleflow conditions 


2.2.1 Create the rule packages 

The Miniloan Rules application first validates the input request data for the loan and the borrower. If the 
data is valid, the rules assesses whether or not the borrower is eligible for the loan. 

When defining the flow of execution, you organize your rules into packages that contain related rules. In 
this case, you have three packages of rules related to computation, eligibility, and validation. A package 
can contain one or more rules, where each rule package is treated as a task in the ruleflow. 

_ 1 . In the Orchestrate section of the Rule Project Map, click Add rule package. 

Note: You can also right-click the rules folder in the Rule Explorer and click New > Rule 
Package. 

_2. In the New Rule Package wizard, name the package validation and then click Finish. 
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Source: /Miniioan Rules/rules 

Browse... 

Package: valicJation| 

Type: RulePackage 

■W 


.3. The new validation rule package appears in the Rule Explorer. This will contain rules that 
assure that loan requests are within valid limits (i.e., the loan amount must be less than 
$1,000,000). 

4. Create another package named computation. This will contain rules for calculating the debt- 
to-income ratio and the monthly repayment. 

.5. Create a third package named eligibility. This will contain rules and a decision table that 
calculate the debt-to-income ratio and determine if the borrower is eligible for the loan. 

.6. Your rule project now contains three packages for storing your rules: computation, 
eligibility, and validation. 



2.2.2 Create the ruleflow 

To define the high level flow of execution for the business rules, you create a ruleflow. In this activity, 
you will organize the business logic such that the loan criteria will be validated, a debt-to-income ratio will 
be calculated, and finally the applicant’s eligibility will be determined. 

To create a ruleflow: 

_1. In the Orchestrate section of the Rule Project Map click Add ruleflow. 
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-V 


Design 




^ Import XOM (1) 

@ 


Orchestrate 

6S Create BOM (1) 

@ 

-► 

Add rule package (4) @ 

‘^1 Define parameters (2) 

@ 


Ji, Add ruleflow @ 

S0 Check project for testing @ 

__-_ y 



2. In the New Ruleflow wizard verify that the Source folder is set to /Miniloan Rules/rules 
and that the Package field is empty. 

.3. In the Name field, type miniloan. The ruleflow name and structure should look like this: 


Source folder: 

Package: 

Name: 

Type: 


/Miniloan Rules/rules 

Browse... 


Browse... 


miniloanj 

RuleFlow 

-W 


_4. Click Finish. 

The Ruleflow Editor opens, and enables you to visually construct the flow of tasks. 

Design the ruleflow: 

_1. Click Create a start node , and then click in the ruleflow editor to add the start node to the 

ruleflow diagram (do not drag the start node). 

_2. Similarly, click Create an end node ® . 

You now have a start point and an end point for your ruleflow diagram. 

_3. Drag the validation rule package from the Rule Explorer and drop it into the ruleflow editor. 

The validation rule package becomes a rule task in the ruleflow. By dropping this package in 
the ruleflow, any rule that you create in the package will be executed at this point in the ruleflow, 
unless you specify otherwise. 

_4. Similarly, drag the two rule packages computation, eligibility from the Rule Explorer 

and drop it below the validation package. Your ruleflow should look similar to the following: 
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0 validation 


0 computation 


0 eligibility 



5. 


Click Create a transition ''V , and create the following transitions (shown as arrows) by clicking 
the first item and then clicking the second. When completed, your ruleflow should look like this: 



Note: The end node has two inbound transition links. 

_6. Click the Layout All Nodes ^ icon to rearrange the ruleflow diagram as shown above: 

_7. Save your work, but leave the miniloan ruleflow open; you will finish the conditions in the next 

activity. 

Some errors appear on the transitions to indicate that conditions are missing. Ignore this for now—we 
will add these conditions in the next activity. 
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2.2.3 Define ruleflow conditions 


You can define conditions on transitions in the ruleflow. In the miniloan ruleflow, you set a transition 
condition so that rules in both the computation and the eligibility packages are run only when 
data is validated. 

Add conditions to the ruiefiow: 


.1. The miniloan ruleflow should Still be open from the last exercise; if not, open it now. 

2. Define the data approved condition from validation to computation. 


a. Double-click the transition iine from validation to computation. 

b. The Properties view should appear at the bottom of Rule Designer. If not, click Window 
> Show View > Properties to open the Properties view and set the condition for this 
transition. 


c. In the Label field type data validated. 

d. Select Use BAL for transition condition to write the condition using the Business 
Action Language (BAL). 


e. In the text area, type a space to display the Content Assist box, and select ' the 

status of <a ioan>, (press enter or click with the mouse), and select ‘the loan' 
and select is <an object> and finally, select Accepted. 


a Properties £3 


Condition 

Documentation 


Label: data validated 

@ Use BAL for transition condition © IRL 
the status of 'the loan' is 


Notice that the transition from validation to the end node is automatically set to else, 
f. Save the changes. Your ruleflow should now look like this: 
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_3. Define a final action for the end node. This will print some additional logging information to the 

console during rule execution. 

_a. Click the end node. The Properties view lets you enter the final action code 

_b. In the Final Action section, type the following final action code: 

print the status of 'the loan' ; 

Properties 

0 Final Attion ® ^ 

Documentation I ' 

This final action will display the status of the loan at the end of rule execution. 

_4. Save your work and close the ruleflow editor. 

You have now defined the flow of execution. In the next task you will author the business rules. 

2.3 Authoring business rules 

In this task, you use Rule Designer to author the business rules in an if-then layout using the vocabulary 
that you created. 

When developing a rule project, the developer writes the initial rules, designs rule templates, and 
organize the folders used to manage the rules. Later, the business user writes and edits these rules in a 
Web environment, though a developer may be asked to write more complex rules. 
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For the purpose of this tutorial, you will create your first business rule and, import the other rules that 
have been prepared for you. 


This task should take you about 30 minutes to complete. 

• Step 1: Create a business rule 

• Step 2: Import remaining rules 


2.3.1 Create an if-then action ruie 

The first business rule you are going to write rejects the loan if the requested loan amount is greater than 
$1,000,000. You will use the content assist completion mechanisms in the Intellirule Editor to help you 
create the rule using the action rule. 

To create business rule do the following: 

_1. In the Author section of the Rule Project Map click Add action rule. 



Note: You can also right-click the validation package in the Rule Explorer and click New > 

Business Rule. 

. 2 . In the New Business Rule wizard type validation for the Package (or click Browse... to 
select it from the list). Name the rule maximum amount. 


Source folder: /Miniloan Rules/rules 
Package: validation 

Name: maximum amountj 


3. Leave the other fields at their default values and click Finish. The Intellirule editor opens and 
allows you to enter the rule logic using the content assist completion. 


.4. Create the conditional if logic. In the Intellirule Editor, type if, and then press the Spacebar. 

if 


The Content Assist box opens 


® it is not true that <conditions 
^ none of the following conditions are true : 
° ®the amount of ca loans _ 

°®the approval status of ca loans 
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Select terms and phrases from the drop-down menu to build the following expression: 

the amount of 'the loan' is more than 1,000,000 
Press Enter for a newline. You will now create the then, or action, clause. 

5. Create the action then clauses. 

_a. Type then, followed by a space, and press ctrl+shift+space to activate the Tree 

Completer. 

_b. In the Tree Completer box type re j ect in the field at the top to only display terms and 

phrases about reject. 

_C. Double-click reject <a loan> with the reason <message>. 

then 



reject 

-V 

Phrases 

O loan 

reject <a loan> with the reason: < message> 


Phrase: 

reject <a loan> with the reason: <messaae> 

Jk, 

w 



_d. Click the placeholders (<...>) to complete the action as follows: 

reject 'the loan' with the reason: "The loan cannot exceed 

1 , 000 , 000 " ; 

Important! You must include a semi-colon (;) at the end of the line. 

6. Press CTRL-i-SHIFT-i-F to format the rule. Your rule should now be: 


Content 

if 

the amount of 'the loan.' is more than 1, 000, 000 

then 

reject 'the loan' with the reason: "Tjie loan cannot exceed 1,000,000" ; 

7. You have created your first if-then action rule. Save your work and close the Intellirule editor. 
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2.3.2 Import the remaining rules 

The Miniloan Rules project requires several if-then rules, similar in structure to the validation rule you 
created in the previous activity. 

So that you do not have to write all the rules to complete the business policy, in particular the rules that 
define whether a borrower is eligible for a loan, you can import the rules from the computation and 
eligibility rule package. 

To import the remaining ruies: 

_1. Click Fiie > import. 

_2. In the Import wizard expand General > File System, and click Next. 

El ■■■& General 

^.^ Archive File 

;.tlS Existing Projects into Workspace 


File System 


^. s Preferences 

.3. In the From directory field, click Browse... and select 

C : \gettingstarted\rules\solutions. Click OK. 

Note: Ignore the message “There are no resources currently selected for import”. This 
is an Eclipse message prompting you to carry out the action you are about to perform. 

.4. The solutions folder appears in the left pane of the Import wizard. Expand the folder to 

solutions/rules and Select the check boxes beside computation and eligibility. 


From directory: C:\gettingstarted\rules\solutions 

■W 

Browse... 

^ solutions 

^ H & rules 

> P computation 

r' f? & eligibility 

> |nj& validation 


[7l 0 debt-to-income.bri 

17\ ® repayment.bri 

17\ variables.var 


From directory: C:\gettingstarted\rules\solutions 

■w 

Browse... 


^ solutions 


[/] 0 minimum credit score.bri 

^ rules 

Bl 

PI 0 minimum income.brI 

r* computation 

> |p |& eligibility 


P prepayment and score.dta 

> validation 
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Note: You should highlight the eligibility or computation folder name rather than 
select the associated checkbox in order to show the rules. 

5. In the Into folder field, click Browse... and select Miniloan Rules, and then click OK. 

6. Click the Overwrite existing resources without warning checkbox. 

Into folder: Miniloan Rules 
Options 

1^ Overwrite existing resources without warning 
O Create complete folder structure 

Advanced >> 


_7. Click Finish. 

When all of your rules are properly loaded, the rule structure should look like this: 


Rule Explorer B 

_■-! I B ^ ^ 

^ & Miniloan Rules 
^ i3 rules 

^ computation 

^ debt-to-income 
® repayment 
variables 
^ ® eligibility 

^ minimum credit score 
® minimum income 
E repayment and score 
^ validation 

^ maximum amount 
K miniloan 
(3 bom 
queries 
resources 
& templates 
© MiniloanSchema.xsd 


2.3.3 View the imported rules and decision table 

Let’s now discover the rules and decision table that have been imported in the previous step. 

To view the imported ruies: 

_1. In the Rule Explorer, expand the computation rules folder and look at the rule: 
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debt-to-income calculates the debt-to-income (often abbreviated DTI), defined as the annual 
loan repayment amount divided by the borrower’s annual salary. 

repayment calculates the annual loan repayment based on the loan amount, loan term, and 
interest rate. 

Note: The debt-to-income rule uses a local variable dti of type int to store the result of the 
calculation. This variable is later reused by the condition column of the decision table 

repayment and score. 



2. In the Rule Explorer, expand the eligibility rules folder and take a few minutes to each rule: 

minimum credit score rejects the loan if the credit score is too low. 

minimum income rejects the loan if the income is too low for the yearly repayments. 

repayment and score is a decision table to assess whether a loan should be approved or 
rejected based on the borrower’s credit score and debt-to-income ratio. 



Debt-to-income % 

credit score 

Loan Status 

Reason 


min 

max 

min 

max 

1 

0 

-30 

B 

0 

200 

Rejected 

debt-to-income too high compared to credit score 

2 


200 

800 

Accepted 


3 

30 

45 

B 

0 

400 

Rejected 

debt-to-income too high compared to credit score 

4 


400 

800 

Accepted 


5 

45 

50 

1? 

0 

600 

Rejected 

debt-to-income too high compared to credit score 

6 


600 

800 

Accepted 


7 

Othsrwise 

1 0 

800 

Rejected 

debt-to-income too high compared to credit score 


You use decision tables to represent rules that share conditions and actions. Each row in a decision 
table represents a rule. By placing your cursor over the number of a row, you can view the test of the 
corresponding rules as hover help. 

_3. Open the rules/miniloan ruleflow by double-clicking on it in the Rule Explorer. 

_4. In the Ruleflow Editor, double-click the eligibility task. 

_5. In the Properties view, click the Rule Selection tab. 
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H Properties E3 


Rule Task 


Rule Selection 


Initial Action 


Final Action 


Documentation 


a 


List the rules and rule packages in the rule task. 


eligibility 


Edit. 


minimum credit score 
minimum income 
" B repayment and score 


Choose dynamic rule selection ; O Dynamic BAL ® Static BAL O IRL 


By default, all the rules participate when the task is executed by the rule engine. 
_6. Close the Ruleflow Editor. 

You have now completed the rules and are ready to test them. 


2.4 Testing rules 

In this task, you create a scenario file to run tests on your rules. 

To validate rules and make sure that the changes have the desired effects, you can test rules against 
scenarios. Decision Validation Services (DVS) scenarios are use cases to validate the behavior of your 
rules. The scenarios and their expected results are stored in an Excel file called “scenario file”. 

Business users can also create scenario files in Decision Center, but you must first prepare the rule 
project in Rule Designer. 

To run the tests in Rule Designer or Decision Center, you must: 

• Validate the rule project and create an Excel scenario file to check the correctness of the output. 

• Enter test data in the Excel scenario files. 

• Run the tests in Rule Designer to ensure that the scenario file works as expected. 

■ This task should take you about 30 minutes to complete. 

• Step 1: Select the arguments 

• Step 2: Create a scenario file 

• Step 3: Populate the Excel scenario file 

• Step 4: Test the Excel scenario file 


2.4.1 Select the arguments 

The ruleset input parameters define the columns in the Excel scenario file template. The BOM classes 
that make up the input parameters have constructors. As this tutorial uses an underlying XML model, all 
the members of both Borrower and Loan classes will be used to generate the sub-columns. 
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Some elements of the model are not required from the input scenario. For example, the loan status is not 
known until we execute the rules. Thus, you will hide some members such loan status from the 
generated Excel scenario file template. 

To ignore some members: 

1. In the Rule Explorer, double-click the Loan class (Miniloan Rules > bom > miniloan > 
miniloan > Loan). The Loan class opens in the BOM Editor. 

2. In the Members section, double-click the status member to edit it. 

3. In the General Information section, select Ignore for DVS. This option ensures that there is no 
column in the Excel scenario file template for the attribute you have excluded. 

fiC miniloan £3 

Member status (class: miniloan.Loan) 

General Information 


Name: status 


Type: java.Iang.String 
Class: miniloan.Loan 

@1 Read/Write O Read Only ©Write Only 

O Static O Final 

n Deprecated O Update object state 
0 Ignore for DVS 

4. In the BOM editor, click the Class tab at the bottom to come back to the Members section of the 
Loan class. 

5. Select Ignore for DVS for two other Members: messagesList and yearlyRepayment. 

6. Save the changes. 

You have defined the members that should be ignored for the Scenarios sheet. Now you can create an 
Excel scenario file. 


2.4.2 Create a scenario file (skip this if the scenario was already generated from Decision 
Center) 

To validate the rules using Decision Validation Services, you create an Excel scenario file template that 
you populate with scenarios to test. 

Before generating the Excel scenario file template, you must check that your project does not contain 
any errors or warnings that could prevent the generation of the Excel file. 
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To create an Excel scenario file; 

1. In the Rule Explorer, select the Miniioan Rules project. 

2. In the Rule Project Map, in the Design part, click Check project for testing. 


Miniioan Rules d&' o'warningd / Q Q Errors ) 


-^ 

Design 



r 

^ Import XOM (1) © 


Orches 

es Create BOM (1) © 


ffi Add rule pa 

‘^i Define parameters (2) @ 


H Add ruleflo\ 

0§ Check project for testing @ 

V 


The DVS Project Validation view opens. Make sure that there are no errors or warnings. 

3. In the Deploy and Integrate of the Rule Project Map, click Create testing scenario file. 

f \ 

Deploy and Integrate 

£? Create RuleAao oroject © 

"* Create client project © 

a' Create testing scenario file © 

^ Package runtime fortesting © 

\ _ 

A. The Generate Excel Scenario File Template wizard opens. On the Rule Project page, make sure 
the rule project Miniioan Rules is selected and click Next. 

5. On the Generation Settings page, select Excel version 2003 and in the Excel Scenario File 
Name field change the name to miniloan-test. xis, and then click Next. 
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w Generate Excel Scenario File Template ^ ^ 

Generation Settings 

Specify the settings for the Excel scenario file template generation. 

Excel Version: 

'4- 2003 

© 20D7-2D1D 

Format: 

@ Default Excel Format 

0 Default Excel Tabbed Format 
©Custom Excel Format 


DVS Project: 

1 Format: 

Language: 

Excel Scenario File Name: 



English(United States) 

/Miniloan Rules/miniloan-test.xls 


6. On the Expected Results page, expand the loan, select status. 


Expected Results 

Select the columns to include in the Expected Results sheet 


Element 

Operator 

^ in the loan 

irn amount 

+ 

irn duration 

+ 

irn messages 

+ 

|f^ status 

equals + 

irn yearly interest rate 

+ 

irn yearly repayment 

+ 


7. Click Finish. 

In the Rule Explorer, the miniloan-test. xis appears in the Miniioan Rules project. 

Note: If miniloan-test. xis does not appear in the project, right-click the project in the 
Rule Explorer, and click Refresh. 
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2.4.3 Populate the Excel scenario file 

To check that the rule project is valid and that the Excel scenario file is correct, you will populate it with 
two simple scenarios that you will test later in this task. 

• Scenario 1 : the original data from the Miniloan Web application. The debt-to-income ratio is too 
high and the loan is rejected. 

• Scenario 2: the amount of the loan is lower (250 000). The expected result is that the loan should 
be approved. 

To populate the Excel scenario file: 

1. In the Rule Explorer, double-click miniloan-test. xis to open it. The file opens in Microsoft 
Excel. 

2. Fill in the Excel scenario file template as follows: 

o Scenarios sheet: 




the borrower 

the loan 

Scenario ID 

description 

1 

credit score 

name 

1 

yearly income 

1 

amount 

1 

duration 

1 

yearly interest rate 

1 rejected loan 


600 

Joe 

soooo 

500000 

240 

0.05 

2 accepted loan 


600 

Joe 

soooo 

250000 

240 

0.05 


Scenarios/^ Expected Results XHELP /^/ 

Note: To add rows, copy and paste the first one. You can also copy/paste the table below: 


1 rejected loan 


600 

Joe 

80000 

500000 

240 

0.05 

2 accepted loan 


600 

Joe 

80000 

250000 

240 

0.05 


o Copy/paste the scenarios ID between the worksheet Scenarios and Expected Results to 
make sure the ID are the same between both worksheets. This should look like this: 


I Scenario ID 

the status of the loan equals 

1 rejected loan 

Rejected 

2 accepted loan 

Accepted 




scenarios , 

Expected 

Results /HELP 


3. Save the file. 

2.4.4 Test the Excel scenario file 

To test that the scenario works as expected, you run the Excel scenario file locally in Rule Designer. 
Running locally means that you execute the scenario using the rule engine embedded in Eclipse. You 
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can also run the test remotely. In this case, the Excel scenario file runs remotely on an application 
server. 

To test the Excel scenario file: 


1. In the menu bar, click Run > Run Configurations. 

2. In the left pane of the Run Configurations, right-click DVS Excel File, and click New. 

3. In the Name field, enter Miniloan Test as the name for the launch configuration. 

4. In the Excel File field, click Browse, select Miniloan Ruies/miniioan-test. xis, and click 

OK. 

5. In the Rule Project field, click Browse, select the Miniloan Rules project, and click OK. 

6. In the HTML Report field, click Browse, select the Miniloan Rules project, click OK. 


g aa X I B ^ ^ 

type filter text 

§ Apache Tomcat 
DVS Archive 
H DVS Excel File 
a Miniloan Test 
♦ Eclipse Application 
@ Eclipse Data Tools 
§ Generic Server 
H Generic Server(Exterr 


Name: Miniloan Test 

Excel Fil^ JRe] Classpath] ^ Extraction"] ^2 


Source: 


Exce I F i Ie: \M i n i 1 0 a n Ru Ie s\m i n i 1 0 a n -te st.xls 

Browse ... 

Rule Project: Miniloan Rules 

Browse ... 

L|JU L. 

HTML Report: \Miniloan Rules\report.html 

Browse ... 


7. Click Apply, and then Run. 


The Console view opens, showing a log of the build process. You can ignore the first two 
warnings. The final result should be Execution finished as follows: 
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S Console _ B X ^ | IFh 

| <terminated> Miniloan Test IDV5 Excel File] C:\IBM\WQDM75\idk\ 

|Dec 6, 2011 6 :46:51 PM iiog . rules , res , xu. log 
INFO: Logging started Decision Server - 7.5. 
Dec 6jr 2011 6:46:51 PM ilog.rnles.res.xn.log 
INFO: JDK Logging level is set to: INFO. 

Dec 6jr 2011 6:46:51 PM ilog. rules. res .persis 
INFO: XOM repository set in file persistence 

-Output for scenario '1 rejected loan' :: 

Rejected 

- Output for scenario '2 accepted loan' : 

Accepted 

Execution finished 


8. In the Rule Explorer, right-click Miniioan Rules and click Refresh. 

The report.html file appears in the project. 

9. In the Rule Explorer, right-click report. htmi, and click Open With > Web Browser. 

The report opens and shows the results of the tests: 

o The execution results are the same as the expected results: the tests are successful. 



Summary 

Execution 


Local 


Decimal Precision 


2 digits are used 


Scenarios 


2 


Tests 


2 


Success Rate 


100% 


Failures 


0 


Errors 


0 



Details for all Scenarios 


Name 

Success Rate 


Tests 

1 reiected ban 

100% 


1 

2 accented loan 

100% 


1 


Now that you have successfully tested the rules, you deploy the rules to the execution server in the next 
task. 
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2.5 Deploying and executing rules on Rule Execution Server 

In this task, you deploy your ruleset to Rule Execution Server. You also retrieve the generated web 
service associated with the ruleset and, finally you validate the business logic you implemented and 
validated in previous tasks is now in Rule Execution Server. 

The rule deployment and the rule execution is performed in two stages: 

• Deploy a RuleApp to Rule Execution Server. A RuleApp is a deployment unit expected by Rule 
Execution Server. In the same way that Java classes are packaged in a JAR file, a ruleset is 
packaged in a JAR file and contains all the rule artifacts necessary for execution (rules, ruleflow, 
and so forth). 

• Once deployed to Rule Executions Server, your application is available as a Hosted Transparent 
Decision Service. You will obtain the WSDL for your rule application and test your rules using the 
Web Services Explorer. 


This task should take you about 30 minutes to complete. 


• Step 1: Deploy the rules from Rule Designer 

• Step 2: View the deployed RuleApp in Rule Execution Server 

• Step 3: Retrieve the Hosted Transparent Decision Service 

• Step 4: Testing the HTDS with the Web Services Test Environment 


2.5.1 Deploy the rules from Rule Designer 

To deploy the rules from Rule Designer, you must first create a RuleApp project. Then, you set some 
properties to enable the monitoring of the ruleset execution. 

To create a RuleApp project and deploy the RuleApp: 

_1. In the Deploy and Integrate section of the Rule Project Map click Create RuleApp project. 


Deploy and Integrate 

> 

& Create RuleApp project 

@ 

Create client project 

@ 

a Create testing scenario file 

@ 

^ Package runtime for testing @ 

_ 



.2. In the New RuleApp Project wizard enter Miniloan RuleApp in the Project name field. Click 

Next. 


Project name: Miniloan RuleAppj 
S Use default location 
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Note: Make sure to respect the same syntax and match the case like in the screenshot. 

.3. The Miniloan Rules rule project Should appear on the Add Ruleset Archives page, since you 
will be creating a ruleset archive from this project. If it is not listed click Add... and select it from 
the list of projects in the workspace. 

£7 Rule Projects j Ruleset Archives | 

Add rule projects: 

Miniloan Rules 


.4. Click Finish. The editor of the Miniloan RuleApp is opened up and the Rule Explorer now has a 

Miniloan RuleApp project. 

.5. As we want to generate and store an execution trace, we need to enable the ruleset execution 
monitoring. Click on the tab Ruleset Archives at the bottom of the RuleApp editor. 

.6. In the list of ruleset of the Ruleset Archives section, select MlnlioanRuies. In the Ruleset 
Properties section on the right, click New button. A property panel opens. Select the 
monitoring.enabled property and set its value to true. You should now see the following: 
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7. Save your work. Go back to the tab Overview and in the Deployment section, click Deploy. 

8. In the Deployment section click Deploy. 

Deployment 

You can: / 

ExDQrl: |^uleADD archive. 

Deploy a RuleApp to one or more Rule Execution Servers. 

9. In the Deploy RuleApp Archive wizard, keep the default deployment type Increment RuleApp 
major version selected. Click Next. 

Deploy a RuleApp to Rule Execution Server 


Select the deployment type: 

(C- Increment RuleApp minor version 
0 Replace RuleApp version 
O Increment rule set major version 
0 Increment ruleset minor version 
0 Replace ruleset version 

10. On the next page, make sure that Create a temporary Rule Execution Server Configuration 

is selected, and enter the following configuration details: 

_a. URL: http://localhost:<PORT>/res 

_b. Login: resAdmin 

c. Password: resAdmin 
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lO) Create a temporary Rule Execution Server configuration: 

U RL: http ://loc a I h o st: 9 081|/re s 

Login: resAdmin 

Password: •••••••• 

W1 Deploy XOM of rule projects and archives contained in the RuleApp 

_11. Click Finish. 

The Console displays the following message, indicating that version 2.0 of MiniloanRuleApp was 
deployed: 

The "Miniloan RuleApp" RuleApp project was successfully deployed on the 
"temporaryServer" configuration. 

/MiniloanRuleApp/1.0 -> /MiniloanRuleApp/2.0: Version changed and element added 
/MiniloanRuleApp/1.0/MiniloanRules/l.0 -> /MiniloanRuleApp/2.0/MiniloanRules/l.0: 
Version changed and element added 

Note: If you have not previously deployed a first version of the RuleApp from either Rule Designer or 
Decision Center, then you will be notified that the version 1.0 of MiniloanRuleApp was deployed. 


2.5.2 View the deployed RuleApp in Rule Execution Server 

You now verify the Miniloan RuleApp deployed properly to Rule Execution Server, which is an execution 
environment for rules (Java SE and Java EE) that interacts with the rule engine. 

Rule Execution Server handles the runtime, management, performance, security, and auditing 
capabilities associated with the execution of your rules. From your application you can access Rule 
Execution Server using web services, EJBs, or pure Java objects (POJOs). 

To view the deployed RuleApp: 

_1. Start Rule Execution Server console using the shortcut from the desktop or from the browser 

favorites. 

_2. Sign in to the Rule Execution Server Console by entering the following URL in a browser: 

http://localhost:<PORT>/res 


Username / password: resAdmin / resAdmin 
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Sign in to the Rule Execution 
Server Console 


User Name 


resAdmin 


Password 


Sign In 


3. Click the Explorer tab (or, alternatively, click the Explorer link from the RES home page). 



.4. Expand RuleApps in the Navigator. 

Notice that Rule Execution Server contains two versions of the RuleApp as one version was 
already deployed in the business lab. The version 2.0 of MiniioanRuieApp, which contains the 
version 1.0 of the MiniioanRuies ruleset was deployed in the previous step. Click 
/MlnlloanRuleApp/2.0 > /MlnlloanRules/1.0 to review the ruleset details. 

N“ vip- ,or 

□ • 10 RuleApps (2) 

© 0 /MiniloariRuleApp/l.O (1) 

B 0 /MiniloanRuleApp/2.0 (1) 

/MlnilaanRules/l.‘0' 

■ 0 Resources 
0 Libraries 

Decision Services 

5. Notice that the status of the ruleset is enabled, indicating that it can be executed at runtime. 


1 (gjTest Ruleset jjjj 

View Statistics View Execution Units Upload Ruleset Archive 


{^/MiniioanRuieApp/2.0/MiniioanRuies/1.0 

Name 

MiniloanRule.s 

Version 

1.0 

Creation Date 

Jan 6, 2012 5:18:00 PM GMT+01:00 

Display Name 

Miniloan Rules 

Description 


Status 

^ enabled 

Debug 

-gj- disabled 

Permanent link 
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The MiniioanRuies ruleset has been successfully deployed to Rule Execution Server. Leave the 
page open; we will continue in the next exercise. 


2.5.3 Retrieve the Hosted Transparent Decision Service 

In this activity you are going to retrieve the Hosted Transparent Decision Service (HTDS). A transparent 
decision service is technically a strongly-typed Web service (WSDL) that provides an interface to access 
a deployed rule set. The Decision Service component can pass one or more input parameters to the rule 
engine and access the return values. The transparent decision service support includes traceability from 
decision services to rules, runtime monitoring and version management. 

_1. You should still be on the MiniioanRuies summary page from the previous exercise. If not, 

click /MiniloanRuleApp/2.0 > /MiniloanRules/1.0, as you did earlier. 

_2. In the toolbar, click Retrieve HTDS WSDL File to configure the WSDL options. Select the 

first two checkboxes Latest ruleset version and Latest RuleApp version: 


^Retrieve HTDS WSDL File 

/MiniloanRuleApp/MiniioanRuies 

[3 Late st ru le s et ve rs io n 
[3 Latest RuleApp version 

□ Decision trace information 

□ Inline types in separate XSD files 

□ Compatibility mode 17.0 l^l 

[ Cancel ] [ View ] [ Download ] 


_3. Click Download. Save the wsdl file to C : \gettingstarted\workspace\Miniloan 
Rules\ MiniloanRuleAppMiniloanRulesDec!sionService.wsdl. 

.4. Open Rule Designer. Right-click the Miniloan Rules Project and select Refresh. The wsdl 
file should be visible in the navigator. Right click on the file and select Refactor > Rename... 
to a shorter name such as MiniioanRuies .wsdl. 
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^ & Miniloan Rules 
& rules 
> 1^ bom 
queries 
& resources 
& templates 
& report_data 
& res_data 
& res _x om 
11 miniloan-test.xls 
MiniloanRuies.wsdl 
© MiniloanSchema.xsd 

5. Double-click the MiniioanRuies. wsdi file to open the WSDL editor as shown below. 
Notice there is a single operation, MiniioanRuies, with an input, output, and fault. 


O MiniloanRulesDecisionService 

® MiniioanRuies 

C>] input 

P MiniloanRulesRequest 

\M\ MiniloanRulesRequest 

0^ output 

P MiniloanRulesResponse 

\M\ MiniloanRulesResponse 

Q MiniloanRulesSoapFault 

P fault 

\M\ MiniloanRulesException 



. 6 . Close the WSDL file, but leave Rule Designer open. 


2.5.4 Testing the HTDS with the Web Services Test Environment 

Now that you have the Decision service WSDL in the Miniloan Application you can test it with the web 
services test environment. 


To run the Web Services Test Environment: 


.1. Open Rule Designer if it is not already open. 

2. In the Rule Explorer switch to the Java perspective. 


^ % Rule 


Java 


.3. Expand the Miniloan Rules project in the Package Explorer, and right-click 

MiniloanRuies.wsdl and select Web Services > Test with Web Services Expiorer. 
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Web Services 

M 

Test with Web Services Explorer 

Decision Validation Services 

i 

> 

Publish WSDL File 

Source 


Generate Java Bean Skeleton 

JPA Tools 

► 

Generate Client 

Properties 

Alt+Enter 

Generate WSIL 

s - ^ 


4. The Web Services Explorer will open. Click the link to MiniioanRuies underneath Operations. 
^ WSDL Binding Details 


Shown below are the details for this SOAP 
endpoints. 

^ Operations 


Name 


MiniioanRuies 

- 


5. You will now be able to invoke the web service for the MiniioanRuies operation. 

_a. Enter the following data for the borrower: 

^ MiniloanRulesRequest 
^ DecisionID string Add Remove 

borrower 
^ borrower 
name string 
Joe 

creditScore int 

|l00 

yearlylncome int 
llOOOO 


b. Enter the following data for the loan: 
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The sample input provides a credit score that is below the minimum limit, which should result in 

the minimum credit score rule firing and the repayment and score decision table 
indicating that the loan should be rejected. 

6. Click Go at the bottom of the Web Services Explorer to call the Miniloan HTDS on Rule 
Execution Server. 


Go Reset 


Examine the response of the decision service in the status panel (you may need to expand the 
Status section to see the response): 
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i Status 

^ Body 

^ MiniloanRuiesResponse 

DecisionID (string): 8f02clla-d5b9-49ec-able-368del9ac83f 
^ loan 
^ loan 

amount (int): 1000 
duration (int): 12 
yearlylnterestRate (double): 2.75 
ye a rlyRe payment (int): 1027 
status (string): Rejected 

messages (string): Debt-to-income ratio is 10% 

debt-to-income too high compared to credit score 
Credit score below 200 

_7. Experiment with different input values to observe the effects of the rules that have been defined 

in Miniloan. 

You have successfully deployed and tested a rule-based decision service. 

2.6 Monitoring the rules 

In this task, you use the Decision Warehouse to audit and view stored decisions. 

Auditors can analyze the execution performance of your rulesets, and troubleshoot any problematic 
transaction that may be reported. To identify the problem when a transaction fails, auditors and analysts 
need to know the business policies that were applied, and the transactional data that was used at 
execution time. 

Decision Warehouse is available from Rule Execution Server and stores ruleset execution traces that 
can be used for auditing purposes. 

In this task, you see how to trace a transaction and view the execution report. 

This task should take you about 15 minutes to complete. 

• Step 1: Search for past transactions in Decision Warehouse 

• Step 2: View the rules fired 

2.6.1 Search for past transactions in Decision Warehouse 
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When you configured the RuleApp, you added the monitoring. enabled ruleset property to monitor 
the execution of the ruleset in Decision Warehouse. Every transaction you simulate for the miniloan 
ruleset is now stored and logged in Decision Warehouse. 

To search for past transactions: 


1. Sign in to Rule Execution Server using the following details: 

Username; resAdmin 
Password: resAdmin 

2. Click the Decision Warehouse tab. 

3. On the Search Decisions page, leave the fields blank, and click Search. 


Decision Warehouse displays the decisions for the transactions that you have executed in the Miniloan 
application using the latest version of the ruleset. For example, the decision for the transaction executed 
when testing the web service shows the date and the processing time, and indicates that four rules were 
fired. 


Qj 1 Decision(s) found 

Display by: | 10 1^1 


1 Decision ID 

Date 

Ruleset Version 

I^unnber of rules fired Decision Trace Processing Time [ms} | 


8fi02jclla-d5b9-^ec-able-368del9ac83f 2D 12-01-06 17:39:5^ /MiniloanRuleApp/2,0/MiniloanRules/l,0 ^ View Decision details 11 


1-1 out of 1 results 


2.6.2 View the rules fired 

You can use Decision Warehouse to understand why the loan has been rejected. You check the 
execution details for a decision and view the rules that were fired. 

To view the execution detaiis for a decision: 

_ 1 . In the table that lists the decisions found, in the Decision Trace column, click the hyperlink View 

Decision detaiis for the decision where one rule was fired. The decision trace details open in a 
new window. 

_2. In the Decision Trace section, expand Ruleflow Tasks to see which rules were executed. 
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^Execution Details 


Decision IQ: 

8f0 2 cl la-d 5 b9-49e c-a b 1 e-3 Sed e 19a c83f 

Date: 

2012-01-06 17:39:54 

Executed ruleset path: 

/Min iloa n Ru le Ap p/ 2.0/ M in iloa n Ru les/1.0 

Processing Time {ms} 

11 

Number of rules flr^ 

4 

Number of tasks executed 

4 


Decision Trace 

0 ,11, Ruleflow Tasks (1} 

□ 0 miniloan (3) 

0 miniloan > validation 

□ 0 miniloan >computation (2) 

a computation. repayment 
9 computation. debt-to-income 

□ 0 miniloan >eligibilitv (2) 

0 eligibility.repayment and score 1 
^ eligibility.minimum credit score 


3. At the bottom, you can also view the input and output parameters as well as the execution 
output: 


Input Parameters 

ban : 

<ql:loan xiilns : ql="rainilQan"> 

< aonount >10 0 0< / amount > 

< dur a t i o n>l 2 < / dur at i o n> 

<yearlyIntere3tRate>2 . 75</yearlyIntere3tRate> 

</ql : loan> 

borrower : 

<?xnil ver3iQn="l . Q" encQding="UTF-E"?> 

<ql : borrower xmln3 : ql = "nilniloan" xmlna : q2="http : //www . ibm. com/rulea/deciaiona 

< name > Jo e< /name > 

<creditScore>100</creditScore> 

<yearlylncome>10000</yearlylncome> 

</ql:borrower> 


Output Parameters 

ban : 

<n30 : loan xmlna : X3i="http : //www . w3 . or g/2Q01/XMLScheii(ia-in3tance " xmlna : n30="ii(LinilQan"> 


Execution output 

Rejected 
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You now have a rule-based powered application ready to be put in the hands of the business user and 
with the execution monitored by IT. 


2.7 Publish the rules to Decision Center 

In this task, you make the rule project that you developed in Rule Designer available to business users in 
Decision Center. 

Decision Center is a web-based environment that allows business users to view, create, edit, and 
simulate rules. From Rule Designer, you publish your rule project to Decision Center, and then 
periodically synchronize the work of the business users from Rule Designer. Furthermore, any changes 
made to the rules in Decision Center can be synchronized with the Rule Designer workspace. 


This task should take you about 15 minutes to complete. 

• Step 1: Publish the rules to Decision Center 

2.7.1 Publish the rules to Decision Center 

In order to make your rule project available to business users, you need to connect to Decision Center 
from Rule Designer and publish Miniloan Rules. 

To publish the rule project to Decision Center: 

_1. In Rule Designer, go back to the Rule Perspective. 

_2. Right-click the Miniloan Rules project and click Decision Center > Connect. 


Decision Center ► 

Connect... 

Rule Execution Server ► 

Decision Validation Services ► 



3. Complete the Decision Center Configuration dialog as follows. The warning message 
Connection not established appears until you establish the connection. 

_a . URL: http://localhost:<PORT>/teamserver 

_b. Username: rtsAdmin 

_c. Password: rtsAdmin 

Note: Leave the Data source field empty. 
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Connection 


|http:^lQcalhQ5t:9081/teamsen^er| 


User name: rtsAdmin 


Password: ******** 


Data source: 


4. Click Connect. The connection to Decision Center is established when the warning message 
disappears from the top of the panel and the Project configuration area becomes active. 

5. As the rule project was already published, the Project configuration area should propose the 
option Synchronize with existing Decision Center project. Click Finish. 

Project configuration 

,' Create a new project on Decision Center 
iO) Synchronize with the existing Decision Center project 
Miniloan Rules main ▼ 


Note: If the project has not been published yet, then the only option will be to create a new: 

Project configuration 

CO) Create a new project on Decision Center 
0 Synchronize with the existing Decision Center project 


6. A dialog appears, asking you if you want to change to Team Synchronizing perspective. Click 

Yes. 

7. The Synchronize perspective displays the differences between Rule Designer and Decision 
Center. As the rule project was published with different identifiers for the labs, some conflicts are 
displayed: 


Synchronize ^ 

cz 


Decision Center Synchronization (/Miniloan Rules - c 

ga - 1 B ^ ^ 1 ^ 1 

:urr 

Sul 



J Miniloan Rules - current 
[> bom 
I> ^ rules 

[> ^ rules/computation 
[> rules/eligibility 
[> ^ rules/validation 
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8. If this was the first time you publish the rule project to Decision Center, you will get the following 
warning: 



9. An empty Synchronize view opens, indicating that the projects in Rule Designer and Decision 
Center are synchronized. Therefore, your rules are now published to Decision Center. We will 
look at the published rules in the next steps. 


Summary 

In this lab you assumed the role as an IT analyst and performed the following tasks: 

• Created a new rule project in Rule Designer 

• Imported an existing execution object model (XOM), from which you created and modified a 
business object model (BOM). 

• Created if-then business rules, a ruleflow, and imported a decision table. 

• Tested the rules against some scenarios. 

• Deployed a project to Rule Execution Server to test the rules in a runtime environment. 

• Published a project to Decision Center. 
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Appendix A. Notices 

This information was developed for products and services offered in the U.S.A. 

IBM may not offer the products, services, or features discussed in this document in other countries. 
Consult your local IBM representative for information on the products and services currently available in 
your area. Any reference to an IBM product, program, or service is not intended to state or imply that 
only that IBM product, program, or service may be used. Any functionally equivalent product, program, or 
service that does not infringe any IBM intellectual property right may be used instead. However, it is the 
user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. 

IBM may have patents or pending patent applications covering subject matter described in this 
document. The furnishing of this document does not grant you any license to these patents. You can 
send license inquiries, in writing, to: 

IBM Director of Licensing 
IBM Corporation 
North Castle Drive 
Armonk, NY 10504-1785 
U.S.A. 

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property 
Department in your country or send inquiries, in writing, to: 

IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106-0032, Japan 

The following paragraph does not apply to the United Kingdom or any other country where such 
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES 
CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, 
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some 
states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this 
statement may not apply to you. 

This information could include technical inaccuracies or typographical errors. Changes are periodically 
made to the information herein; these changes will be incorporated in new editions of the publication. 

IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 

Any references in this information to non-IBM Web sites are provided for convenience only and do not in 
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part 
of the materials for this IBM product and use of those Web sites is at your own risk. 

IBM may use or distribute any of the information you supply in any way it believes appropriate without 
incurring any obligation to you. 

Any performance data contained herein was determined in a controlled environment. Therefore, the 
results obtained in other operating environments may vary significantly. Some measurements may have 
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been made on development-level systems and there is no guarantee that these measurements will be 
the same on generally available systems. Furthermore, some measurements may have been estimated 
through extrapolation. Actual results may vary. Users of this document should verify the applicable data 
for their specific environment. 

Information concerning non-IBM products was obtained from the suppliers of those products, their 
published announcements or other publicly available sources. IBM has not tested those products and 
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM 
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of 
those products. 

All statements regarding IBM's future direction and intent are subject to change or withdrawal without 
notice, and represent goals and objectives only. 

This information contains examples of data and reports used in daily business operations. To illustrate 
them as completely as possible, the examples include the names of individuals, companies, brands, and 
products. All of these names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. All references to fictitious companies or individuals are 
used for illustration purposes only. 

COPYRIGHT LICENSE: 

This information contains sample application programs in source language, which illustrate programming 
techniques on various operating platforms. You may copy, modify, and distribute these sample programs 
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing 
application programs conforming to the application programming interface for the operating platform for 
which the sample programs are written. These examples have not been thoroughly tested under all 
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these 
programs. 
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Appendix B. Trademarks and copyrights 

The following terms are trademarks of International Business Machines Corporation in the United States, 
other countries, or both: 


IBM 

AIX 

CICS 

ClearCase 

ClearQuest 

Cloudscape 

Cube Views 

DB2 

developerWorks 

DRDA 

IMS 

1 MS/ESA 

Informix 

Lotus 

Lotus Workflow 

MQSeries 

OmniFind 

ILOG 

Rational 

Redbooks 

Red Brick 

RequisitePro 

System i 


System z 

Tivoli 

WebSphere 

Workplace 

System p 



Adobe, Acrobat, Portable Document Format (PDF), and PostScript are either registered trademarks or 
trademarks of Adobe Systems Incorporated in the United States, other countries, or both. 

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other 
countries, or both and is used under license therefrom. 

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United 
States, other countries, or both. See Java Guidelines 

Microsoft, Windows, Windows NT, and the Windows logo are registered trademarks of Microsoft 
Corporation in the United States, other countries, or both. 

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel 
SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its 
subsidiaries in the United States and other countries. 

UNIX is a registered trademark of The Open Group in the United States and other countries. 

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. 

ITIL is a registered trademark and a registered community trademark of the Office of Government 
Commerce, and is registered in the U.S. Patent and Trademark Office. 

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications 
Agency which is now part of the Office of Government Commerce. 

Other company, product and service names may be trademarks or service marks of others. 
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